plan9fox/sys/man/1/pkg

119 lines
2 KiB
Plaintext
Raw Normal View History

2011-05-16 03:42:06 +00:00
.TH PKG 1
.SH NAME
2012-07-05 03:20:46 +00:00
create, install, list, local, remove, unpkg \- trivial package management
2011-05-16 03:42:06 +00:00
.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
2012-07-05 03:20:46 +00:00
.br
.B pkg/unpkg
2011-05-16 03:42:06 +00:00
.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 ,
2011-05-23 21:32:09 +00:00
whose source is found in directory
.IR name ,
2011-05-16 03:42:06 +00:00
then packs it into a
2011-08-26 09:27:38 +00:00
.I bzip2 (see
.IR gzip (1))
2011-05-16 03:42:06 +00:00
compressed
.IR tar (1)
2011-05-16 03:42:06 +00:00
archive suitable for upload to a package
repository. The source directory should be provided as a full path.
2011-05-16 03:42:06 +00:00
.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/.
2011-05-16 03:42:06 +00:00
.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.
2012-07-05 03:20:46 +00:00
.TP
.I Pkg/unpkg
A modified
.IR tar (1)
used by
.B pkg/install
to generate checksums for every unpacked file.
2011-05-16 03:42:06 +00:00
.SH EXAMPLES
2011-05-23 21:32:09 +00:00
.LP
Create the package
2012-07-05 03:20:46 +00:00
.B irc7-2012.06.22:
2011-05-23 21:32:09 +00:00
.sp 1
.EX
2012-07-05 03:20:46 +00:00
% pkg/create /sys/src/pkg/irc7-2012.06.22
2011-05-23 21:32:09 +00:00
.EE
2011-05-16 03:42:06 +00:00
.LP
Install the
2012-07-05 03:20:46 +00:00
.B gopherd
server:
2011-05-16 03:42:06 +00:00
.sp 1
.EX
2012-07-05 03:20:46 +00:00
% pkg/install gopherd-2012.04.15
2011-05-16 03:42:06 +00:00
.EE
.SH FILES
2012-01-04 02:19:06 +00:00
.TF
2011-05-16 03:42:06 +00:00
.TP
.B /sys/lib/pkg/*
hash files of packages installed locally.
2012-01-04 02:19:06 +00:00
.TP
.B /sys/src/pkg/*
source files of packages installed locally.
2011-05-16 03:42:06 +00:00
.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
2012-06-05 19:19:07 +00:00
.B http://r-36.net/9front/pkg/386
.br
2012-06-03 03:57:12 +00:00
.B http://ph.inri.net/9front/pkg/386
2012-08-08 14:37:53 +00:00
.br
2012-10-23 23:08:18 +00:00
.B http://bell-labs.co/9front/pkg/386
2011-05-16 03:42:06 +00:00
.SH SEE ALSO
2012-07-05 03:20:46 +00:00
.IR contrib (1) ,
.IR gzip (1) ,
.IR tar (1)