pkgadd.8 and prt-get.8: more details added
This commit is contained in:
parent
b0fd60049d
commit
06789efe1b
|
@ -2,20 +2,35 @@
|
||||||
.SH NAME
|
.SH NAME
|
||||||
pkgadd \- install software package
|
pkgadd \- install software package
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
\fBpkgadd [options] <file>\fP
|
\fBpkgadd [options] <package>\fP
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
\fBpkgadd\fP is a \fIpackage management\fP utility, which installs
|
\fBpkgadd\fP is a \fIpackage management\fP utility, which installs
|
||||||
a software package. A \fIpackage\fP is an archive of files (.pkg.tar.gz).
|
a software package. A \fIpackage\fP is an archive of files (.pkg.tar.gz).
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
.TP
|
.TP
|
||||||
.B "\-u, \-\-upgrade"
|
.B "\-u, \-\-upgrade"
|
||||||
Upgrade/replace package with the same name as <file>.
|
Upgrade/replace package with the same name as <package>. This action
|
||||||
|
comprises several steps. First the contents of <package> are matched against
|
||||||
|
the INSTALL NO directives in pkgadd.conf, and against those files listed in /var/lib/pkg/db
|
||||||
|
that are NOT owned by the previously-installed version of <package>. Any file owned by the
|
||||||
|
previously-installed version is considered eligible for overwriting, unless it matches an
|
||||||
|
UPGRADE NO directive in pkgadd.conf.
|
||||||
|
|
||||||
|
At this point pkgadd has constructed a "non-install" list, a "conflicting files" list, and a "keep"
|
||||||
|
list. (The "keep" list is unique to an upgrade operation, but the other two lists also affect a
|
||||||
|
regular install operation.)
|
||||||
|
|
||||||
|
After writing the anticipated changes to the package database, \fIpkgadd\fP finishes by unpacking
|
||||||
|
the contents of <package> onto the filesystem, using the "keep" list to shield wanted files from
|
||||||
|
deletion, and the "conflicting files" list to skip the installation unless \-f is in effect. (See
|
||||||
|
the next option.) Files that were not written to the disk are preserved under /var/lib/pkg/rejected
|
||||||
|
(See the \fBCONFIGURATION\fP section for details).
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.B "\-f, \-\-force"
|
.B "\-f, \-\-force"
|
||||||
Force installation, overwrite conflicting files. If the package
|
Force installation, overwrite conflicting files. If <package> contains files
|
||||||
that is about to be installed contains files that are already
|
that are already on the filesystem, this option will cause all those files to
|
||||||
installed this option will cause all those files to be overwritten.
|
be overwritten. This option should be used with care, preferably not at all.
|
||||||
This option should be used with care, preferably not at all.
|
|
||||||
.TP
|
.TP
|
||||||
.B "\-r, \-\-root <altroot>"
|
.B "\-r, \-\-root <altroot>"
|
||||||
Specify alternative installation root (default is "/"). This
|
Specify alternative installation root (default is "/"). This
|
||||||
|
@ -25,6 +40,10 @@ if you want to install a package on a temporary mounted partition,
|
||||||
which is "owned" by another system. By using this option you not only
|
which is "owned" by another system. By using this option you not only
|
||||||
specify where the software should be installed, but you also
|
specify where the software should be installed, but you also
|
||||||
specify which package database will be used.
|
specify which package database will be used.
|
||||||
|
|
||||||
|
\fBpkgadd\fP processes spawned by \fBprt\-get install \-r <altroot>\fP will modify
|
||||||
|
the package database under <altroot>, but the preliminary steps of downloading sources
|
||||||
|
and building the requested packages can occur in a ports tree outside the <altroot> location.
|
||||||
.TP
|
.TP
|
||||||
.B "\-c, \-\-config <path>"
|
.B "\-c, \-\-config <path>"
|
||||||
Specify an alternative configuration file (default is "/etc/pkgadd.conf",
|
Specify an alternative configuration file (default is "/etc/pkgadd.conf",
|
||||||
|
@ -48,13 +67,15 @@ UPGRADE ^etc/X11/.*$ YES
|
||||||
UPGRADE ^etc/X11/XF86Config$ NO
|
UPGRADE ^etc/X11/XF86Config$ NO
|
||||||
.fi
|
.fi
|
||||||
|
|
||||||
The above example will cause pkgadd to never upgrade anything in /etc/ or /var/log/ (subdirectories included),
|
The above example will cause pkgadd to never upgrade anything in /etc/ or /var/log/
|
||||||
except files in /etc/X11/ (subdirectories included), unless it is the file /etc/X11/XF86Config.
|
(subdirectories included), except files in /etc/X11/ (subdirectories included),
|
||||||
|
unless it is the file /etc/X11/XF86Config.
|
||||||
The default rule is to upgrade/install everything, rules in this file are exceptions to that rule.
|
The default rule is to upgrade/install everything, rules in this file are exceptions to that rule.
|
||||||
(NOTE! A \fIpattern\fP should never contain an initial "/" since you are referring to the files in the
|
(NOTE! A \fIpattern\fP should never contain an initial "/" since you are referring to the files in the
|
||||||
package, not the files on the disk.)
|
package, not the files on the disk.)
|
||||||
|
|
||||||
If pkgadd finds that a specific file should not be upgraded it will install it under \fI/var/lib/pkg/rejected/\fP.
|
If pkgadd finds that a specific file should not be upgraded it will install it under
|
||||||
|
\fI/var/lib/pkg/rejected/\fP.
|
||||||
The user is then free to examine/use/remove that file manually.
|
The user is then free to examine/use/remove that file manually.
|
||||||
.SH FILES
|
.SH FILES
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -410,7 +410,7 @@ Check whether each package given on the command line is installed. Output in the
|
||||||
arguments is separated by newlines, suitable for processing by awk or grep. Similar to
|
arguments is separated by newlines, suitable for processing by awk or grep. Similar to
|
||||||
.B pkginfo \-i|grep \-E '^(package1|package2|...)'
|
.B pkginfo \-i|grep \-E '^(package1|package2|...)'
|
||||||
but does not print the version information. This command has a return value of 0 if
|
but does not print the version information. This command has a return value of 0 if
|
||||||
<package> is installed, otherwise a return value greater than 0.
|
all packages given as argument are installed, otherwise a return value greater than 0.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.B current <package>
|
.B current <package>
|
||||||
|
|
Loading…
Reference in New Issue