Commit | Line | Data |
---|---|---|
9ac667e6 SR |
1 | .TH pkgadd 8 "" "pkgutils #VERSION#" "" |
2 | .SH NAME | |
3 | pkgadd \- install software package | |
4 | .SH SYNOPSIS | |
5 | \fBpkgadd [options] <file>\fP | |
6 | .SH DESCRIPTION | |
7 | \fBpkgadd\fP is a \fIpackage management\fP utility, which installs | |
8 | a software package. A \fIpackage\fP is an archive of files (.pkg.tar.gz). | |
9 | .SH OPTIONS | |
10 | .TP | |
11 | .B "\-u, \-\-upgrade" | |
12 | Upgrade/replace package with the same name as <file>. | |
13 | .TP | |
14 | .B "\-f, \-\-force" | |
15 | Force installation, overwrite conflicting files. If the package | |
16 | that is about to be installed contains files that are already | |
17 | installed this option will cause all those files to be overwritten. | |
18 | This option should be used with care, preferably not at all. | |
19 | .TP | |
20 | .B "\-r, \-\-root <path>" | |
21 | Specify alternative installation root (default is "/"). This | |
22 | should \fInot\fP be used as a way to install software into | |
23 | e.g. /usr/local instead of /usr. Instead this should be used | |
24 | if you want to install a package on a temporary mounted partition, | |
25 | which is "owned" by another system. By using this option you not only | |
26 | specify where the software should be installed, but you also | |
27 | specify which package database to use. | |
28 | .TP | |
29 | .B "\-v, \-\-version" | |
30 | Print version and exit. | |
31 | .TP | |
32 | .B "\-h, \-\-help" | |
33 | Print help and exit. | |
34 | .SH CONFIGURATION | |
35 | When using \fBpkgadd\fP in upgrade mode (i.e. option -u is used) the | |
36 | file \fI/etc/pkgadd.conf\fP will be read. This file can contain rules describing | |
37 | how pkgadd should behave when doing upgrades. A rule is built out of three | |
38 | fragments, \fIevent\fP, \fIpattern\fP and \fIaction\fP. The event describes | |
39 | in what kind of situation this rule applies. Currently only one type of event is | |
40 | supported, that is \fBUPGRADE\fP. The pattern is a regular expression and the action | |
41 | applicable to the \fBUPGRADE\fP event is \fBYES\fP and \fBNO\fP. More than one rule of the same | |
42 | event type is allowed, in which case the first rule will have the lowest priority and the last rule | |
43 | will have the highest priority. Example: | |
44 | ||
45 | .nf | |
46 | UPGRADE ^etc/.*$ NO | |
47 | UPGRADE ^var/log/.*$ NO | |
48 | UPGRADE ^etc/X11/.*$ YES | |
49 | UPGRADE ^etc/X11/XF86Config$ NO | |
50 | .fi | |
51 | ||
52 | The above example will cause pkgadd to never upgrade anything in /etc/ or /var/log/ (subdirectories included), | |
53 | except files in /etc/X11/ (subdirectories included), unless it is the file /etc/X11/XF86Config. | |
54 | The default rule is to upgrade everything, rules in this file are exceptions to that rule. | |
55 | (NOTE! A \fIpattern\fP should never contain an initial "/" since you are referring to the files in the | |
56 | package, not the files on the disk.) | |
57 | ||
58 | If pkgadd finds that a specific file should not be upgraded it will install it under \fI/var/lib/pkg/rejected/\fP. | |
59 | The user is then free to examine/use/remove that file manually. | |
60 | .SH FILES | |
61 | .TP | |
62 | .B "/etc/pkgadd.conf" | |
63 | Configuration file. | |
64 | .SH SEE ALSO | |
65 | pkgrm(8), pkginfo(8), pkgmk(8), rejmerge(8) | |
66 | .SH COPYRIGHT | |
67 | pkgadd (pkgutils) is Copyright (c) 2000-2005 Per Liden and is licensed through | |
68 | the GNU General Public License. Read the COPYING file for the complete license. |