]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/pkg
pkg(1): update man page
[plan9front.git] / sys / man / 1 / pkg
1 .TH PKG 1
2 .SH NAME
3 create, install, list, local, remove \- trivial package management
4 .SH SYNOPSIS
5 .B pkg/create
6 .I name
7 .br
8 .B pkg/install
9 .I name
10 .br
11 .B pkg/list
12 .br
13 .B pkg/local
14 .br
15 .B pkg/remove
16 .I name
17 .SH DESCRIPTION
18 .I Pkg 
19 is a simple package management system primarily written in
20 .IR rc (1).
21 It can be used to create, install, and remove software packages
22 from an arbitrary package repository, indicated by the environment
23 variable
24 .I $pkgpath.
25 If
26 .I $pkgpath
27 is not set, the system defaults to a hardcoded repository of approved
28 packages.
29 .TP
30 .I Pkg/create 
31 Create builds a new package
32 .IR name ,
33 whose source is found in directory
34 .IR name ,
35 then packs it into a
36 .IR bzip2 (1)
37 compressed
38 .IR tar(1)
39 archive suitable for upload to a package
40 repository.
41 .TP
42 .I Pkg/install 
43 Install the package
44 .I name
45 from the current repository.
46 .TP
47 .I Pkg/list
48 List packages available from the current repository.
49 .TP
50 .I Pkg/local
51 List locally installed packages.
52 .TP
53 .I Pkg/remove
54 Remove the package
55 .I name
56 from the local system.
57 .SH EXAMPLES
58 .LP
59 Create the package
60 .B links-variable-2011.05.23
61 .sp 1
62 .EX
63 % cd /sys/src
64 % pkg/create links-variable-2011.05.23
65 .EE
66
67 .LP
68 Install the
69 .B Go
70 programming language.
71 .sp 1
72 .EX
73 % pkg/install go-2011.05.10
74 .EE
75 .SH FILES
76 .TF /sys/lib/pkg/*
77 .TP
78 .B /sys/lib/pkg/*
79 hash files of packages installed locally.
80 .SH SOURCE
81 .B /sys/src/cmd/pkg/create
82 .br
83 .B /sys/src/cmd/pkg/install
84 .br
85 .B /sys/src/cmd/pkg/list
86 .br
87 .B /sys/src/cmd/pkg/local
88 .br
89 .B /sys/src/cmd/pkg/remove
90 .br
91 .B /sys/src/cmd/pkg/unpkg.c
92 .SH SEE ALSO
93 .IR contrib (1)