]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/pkg
mothra: add keyboard command a to collapse/expand navigation boxes
[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 .I bzip2 (see
37 .IR gzip (1))
38 compressed
39 .IR tar (1)
40 archive suitable for upload to a package
41 repository. The source directory should be provided as a full path.
42 .TP
43 .I Pkg/install 
44 Install the package
45 .I name
46 from the current repository.
47 .TP
48 .I Pkg/list
49 List packages available from the current repository.
50 .TP
51 .I Pkg/local
52 List locally installed packages.
53 .TP
54 .I Pkg/remove
55 Remove the package
56 .I name
57 from the local system.
58 .SH EXAMPLES
59 .LP
60 Create the package
61 .B irc7-2011.09.21:
62 .sp 1
63 .EX
64 % pkg/create /sys/src/cmd/irc7-2011.09.21
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)