forked from NetBSDfr/pkgin
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathpkgin.1
292 lines (292 loc) · 7.93 KB
/
pkgin.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
.\" $NetBSD: pkgin.1,v 1.0 2009/04/24 18:49:08 guigui2 Exp $
.\"
.\" View with following command: nroff -msafer -man pkgin.1 | more
.\"
.Dd Dec 6, 2009
.Dt PKGIN 1
.Os
.Sh NAME
.Nm pkgin
.Nd A tool to manage pkgsrc binary packages.
.Sh SYNOPSIS
.Nm
.Op Fl dfFhPvVyn
.Op Fl l Ar limit_chars
.Op Fl c Ar chroot_path
.Op Fl t Ar log_file
.Ar command
.Op Ar package Ar ...
.Sh DESCRIPTION
The
.Nm
command is aimed at being an apt /
yum like tool for managing pkgsrc binary packages.
It relies on
.Xr pkg_summary 5
for installation, removal and upgrade
of packages and associated dependencies, using a remote repository.
.Sh OPTIONS
The following command line arguments are supported:
.Bl -tag -width indent
.It Fl d
Download only.
.It Fl f
Force database update.
.It Fl F
Force package reinstall.
.It Fl h
Displays help for the command.
.It Fl P
Displays packages versions instead of globs (sd, sfd, srd)
.It Fl v
Displays
.Nm
version
.It Fl V
Be verbose when (un)installing
.It Fl y
Assumes "yes" as default answer, except for autoremove.
.It Fl n
Assumes "no" as default answer.
.It Fl l Ar limit_chars
Only include the packages with the specified status flags.
.It Fl c Ar chroot_path
Enable chrooting pkgin in the given repository
.It Fl t Ar log_file
Logs package browsing (dependencies and impact) to a given log file
.El
.Pp
The
.Nm
utility provides several commands:
.Pp
.Bl -tag -width Fl -compact
.It Cm autoremove
Automatically removes orphan dependencies.
.It Cm avail
Lists all packages available in the repository.
.It Cm clean
Delete downloaded packages from the cache directory.
.It Cm export
Export the list of non-autoremovable packages to stdout
(one category/package by line)
.It Cm full-upgrade
Upgrade all packages to their newer versions present in the
repository.
.It Cm import Ar file
Import a list of packages to be installed from file
(one category/package by line)
.It Cm install Ar package Ar ...
Performs installation or upgrade of
.Ar package .
If more than one packages are specified on the command-line, all
will be installed (or upgraded).
.It Cm keep Ar package Ar ...
Marks
.Ar package
as "non auto-removable".
This means that a package that has, for instance, been compiled
manually from pkgsrc, can't be removed through a
.Nm
upgrade.
More than one package can be specified on the command-line, to mark
several packages as non-removable in a single command.
.It Cm list
Lists all packages installed locally on a system. If the
.Ar l
modifier is added to this command, show only packages matching the status flag.
.It Cm pkg-content Ar package
Show remote
.Ar package
content.
.It Cm pkg-descr Ar package
Show remote
.Ar package
long-description.
.It Cm pkg-build-defs Ar package
Show remote
.Ar package
build definitions.
.It Cm provides Ar package
Shows what a
.Ar package
provides to others
.It Cm remove Ar package Ar ...
Removes
.Ar package
as well as all packages depending on it.
When more than one package are specified, they will all be uninstalled.
By default, it will prompt you to confirm before package removals.
.It Cm requires Ar package
Shows what a
.Ar package
requires from others
.Ar packages .
.It Cm search Ar pattern
Performs a regular expression search for a pattern in the repository.
.It Cm show-deps
Displays all direct dependencies
.It Cm show-full-deps Ar package
Displays all direct dependencies recursively
.It Cm show-rev-deps Ar package
Displays all reverse direct dependencies for
.Ar package .
If more than one package is specified,
.Nm
will show recursively reverse direct dependencies for all packages
on the command-line.
.It Cm show-category Ar category
Show packages belonging to
.Ar category .
.It Cm show-pkg-category Ar package
Show
.Ar package
category.
.It Cm show-keep
Display "non auto-removable" packages.
.It Cm show-no-keep
Display "auto-removable" packages.
.It Cm unkeep Ar package Ar ...
Marks
.Ar package
as "auto-removable".
If no other package depends on it, it will be removed when using
the autoremove modifier.
.It Cm update
Creates and populates the initial database of locally installed packages
and available packages (from the remote
.Xr pkg_summary 5
list).
This is done automatically when
.Nm
is first used,
when the system package database has been modified.
or when
.Nm
is upgraded to a new database version.
.It Cm upgrade
Upgrade keepable packages to their newer versions present in the
repository.
If the installed dependencies match the listed needed dependencies,
don't upgrade them.
.El
.Sh STATUS FLAGS
.Pp
When using the
.Ar l
flag along with the
.Ar list
command, the following status flag must be set:
.Bl -tag -width indent
.It Li =
The installed version of the package is current.
.It Li \&<
The installed version of the package is older than the current version.
.It Li \&>
The installed version of the package is newer than the current version.
.El
.Sh ENVIRONMENT
.Bl -tag -width indent
.It Ev PKG_REPOS
The
.Ev PKG_REPOS
environment variable can be pointed to a suitable repository or a list of
space separated repositories in order to override
.Pa /usr/pkg/etc/pkgin/repositories.conf
.El
.Sh FILES
.Bl -tag -width Ds -compact
.It /usr/pkg/etc/pkgin/repositories.conf
This file contains a list of repository URIs that
.Nm
will use.
It may contain macros
.Va $arch
to define the machine hardware platform
and
.Va $osrelease
to define the release version for the operating system
(as reported by
.Xr uname 3 ) .
.El
.Sh EXAMPLES
.Pp
Setup the initial database:
.Bd -literal
# echo ftp://ftp.fr.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/5.0/All > /usr/pkg/etc/pkgin/repositories.conf
# pkgin update
processing local summary...
updating database: 100%
downloading pkg_summary.bz2: 100%
processing remote summary (ftp://ftp.fr.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/5.0/All)...
updating database: 100%
.Ed
.Pp
Listing all packages available in the repository:
.Bd -literal
# pkgin avail | more
[...]
autoconf-2.63 Generates automatic source code configuration scripts
aumix-gtk-2.8nb3 Set mix levels (ncurses and GTK+ 2.0 interfaces)
aumix-2.8nb7 Set mix levels (ncurses interface only)
august-0.63b Simple Tk-based HTML editor
audacity-1.2.6nb3 Audio editor
[...]
.Ed
.Pp
Install packages and their dependencies:
.Bd -literal
# pkgin install links eterm
nothing to upgrade.
11 packages to be installed: tiff-3.8.2nb4 png-1.2.35 libungif-4.1.4nb1 libltdl-1.5.26 jpeg-6bnb4 pcre-7.8 perl-5.10.0nb5 libast-0.6.1nb3 imlib2-1.4.2nb1 links-2.2nb1 eterm-0.9.4nb1 (25M to download, 64M to install)
proceed ? [y/N]
.Ed
.Pp
Remove packages and their reverse dependencies:
.Bd -literal
# pkgin remove links eterm
2 packages to delete: links-2.2nb1 eterm-0.9.4nb1
proceed ? [y/N]
.Ed
.Pp
Remove orphan dependencies:
.Bd -literal
# pkgin autoremove
in order to remove packages from the autoremove list, flag those with the -k modifier.
9 packages to be autoremoved: libast-0.6.1nb3 pcre-7.8 imlib2-1.4.2nb1 tiff-3.8.2nb4 png-1.2.35 libungif-4.1.4nb1 libltdl-1.5.26 perl-5.10.0nb5 jpeg-6bnb4
proceed ? [y/N]
.Ed
.Pp
.Sh SEE ALSO
.Xr pkg_add 1 ,
.Xr pkg_info 1 ,
.Xr pkg_summary 5 ,
.Xr pkgsrc 7
.Sh AUTHORS
.Bl -tag -width indent -compact
.It Emile Do "iMil" Dc Heitor
Initial work and ongoing development.
.El
.Sh CONTRIBUTORS
.Bl -tag -width indent -compact
.It Jeremy C. Reed
Testing and refinements.
.It Arnaud Ysmal
Tests and patches
.It Claude Charpentier
SQLite schema, and SQL queries debugging.
.It Guillaume Lasmayous
Man page
.It Antonio Huete Jimenez
DragonFly port
.It Min Sik Kim
Darwin port
.It Filip Hajny
SunOS port
.It Baptiste Daroussin
FreeBSD port and patches
.It Gautam B.T.
MINIX port
.El
.Sh BUGS
We're hunting them.