119 lines
2 KiB
Text
119 lines
2 KiB
Text
.TH PKG 1
|
|
.SH NAME
|
|
create, install, list, local, remove, unpkg \- trivial package management
|
|
.SH SYNOPSIS
|
|
.B pkg/create
|
|
.I name
|
|
.br
|
|
.B pkg/install
|
|
.I name
|
|
.br
|
|
.B pkg/list
|
|
.br
|
|
.B pkg/local
|
|
.br
|
|
.B pkg/remove
|
|
.I name
|
|
.br
|
|
.B pkg/unpkg
|
|
.SH DESCRIPTION
|
|
.I Pkg
|
|
is a simple package management system primarily written in
|
|
.IR rc (1).
|
|
It can be used to create, install, and remove software packages
|
|
from an arbitrary package repository, indicated by the environment
|
|
variable
|
|
.I $pkgpath.
|
|
If
|
|
.I $pkgpath
|
|
is not set, the system defaults to a hardcoded repository of approved
|
|
packages.
|
|
.TP
|
|
.I Pkg/create
|
|
Create builds a new package
|
|
.IR name ,
|
|
whose source is found in directory
|
|
.IR name ,
|
|
then packs it into a
|
|
.I bzip2 (see
|
|
.IR gzip (1))
|
|
compressed
|
|
.IR tar (1)
|
|
archive suitable for upload to a package
|
|
repository. The source directory should be provided as a full path.
|
|
.TP
|
|
.I Pkg/install
|
|
Install the package
|
|
.I name
|
|
from the current repository, unpacking the executables in
|
|
.B /$cputype/bin/
|
|
or
|
|
.B /rc/bin/
|
|
and the source in
|
|
.B /sys/src/pkg/.
|
|
.TP
|
|
.I Pkg/list
|
|
List packages available from the current repository.
|
|
.TP
|
|
.I Pkg/local
|
|
List locally installed packages.
|
|
.TP
|
|
.I Pkg/remove
|
|
Remove the package
|
|
.I name
|
|
from the local system.
|
|
.TP
|
|
.I Pkg/unpkg
|
|
A modified
|
|
.IR tar (1)
|
|
used by
|
|
.B pkg/install
|
|
to generate checksums for every unpacked file.
|
|
.SH EXAMPLES
|
|
.LP
|
|
Create the package
|
|
.B irc7-2012.06.22:
|
|
.sp 1
|
|
.EX
|
|
% pkg/create /sys/src/pkg/irc7-2012.06.22
|
|
.EE
|
|
|
|
.LP
|
|
Install the
|
|
.B gopherd
|
|
server:
|
|
.sp 1
|
|
.EX
|
|
% pkg/install gopherd-2012.04.15
|
|
.EE
|
|
.SH FILES
|
|
.TF
|
|
.TP
|
|
.B /sys/lib/pkg/*
|
|
hash files of packages installed locally.
|
|
.TP
|
|
.B /sys/src/pkg/*
|
|
source files of packages installed locally.
|
|
.SH SOURCE
|
|
.B /sys/src/cmd/pkg/create
|
|
.br
|
|
.B /sys/src/cmd/pkg/install
|
|
.br
|
|
.B /sys/src/cmd/pkg/list
|
|
.br
|
|
.B /sys/src/cmd/pkg/local
|
|
.br
|
|
.B /sys/src/cmd/pkg/remove
|
|
.br
|
|
.B /sys/src/cmd/pkg/unpkg.c
|
|
.SH REPOSITORIES
|
|
.B http://r-36.net/9front/pkg/386
|
|
.br
|
|
.B http://plan9.bell-labs.com/sources/contrib/staal1978/pkg
|
|
.SH SEE ALSO
|
|
.IR contrib (1) ,
|
|
.IR gzip (1) ,
|
|
.IR tar (1)
|
|
.SH HISTORY
|
|
.I Pkg
|
|
first appeared in 9front (May, 2011).
|