Ispell. Begin new sentences on a new line.
This commit is contained in:
parent
e3ff4e979b
commit
5e977f5ead
|
@ -1,6 +1,6 @@
|
||||||
.\" $NetBSD: pkg_add.1,v 1.37 2002/09/24 03:18:00 uebayasi Exp $
|
.\" $NetBSD: pkg_add.1,v 1.38 2002/09/26 01:41:51 wiz Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" FreeBSD install - a package for the installation and maintainance
|
.\" FreeBSD install - a package for the installation and maintenance
|
||||||
.\" of non-core utilities.
|
.\" of non-core utilities.
|
||||||
.\"
|
.\"
|
||||||
.\" Redistribution and use in source and binary forms, with or without
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
|
@ -53,19 +53,20 @@ depends on or requires from both local disk and via FTP.
|
||||||
Since the
|
Since the
|
||||||
.Nm
|
.Nm
|
||||||
command may execute scripts or programs contained within a package file,
|
command may execute scripts or programs contained within a package file,
|
||||||
your system may be susceptible to ``trojan horses'' or other subtle
|
your system may be susceptible to ``Trojan horses'' or other subtle
|
||||||
attacks from miscreants who create dangerous package files.
|
attacks from miscreants who create dangerous package files.
|
||||||
.Pp
|
.Pp
|
||||||
You are advised to verify the competence and identity of those who
|
You are advised to verify the competence and identity of those who
|
||||||
provide installable package files. For extra protection, use the
|
provide installable package files.
|
||||||
digital signatures provided where possible (see the
|
For extra protection, use the digital signatures provided where possible
|
||||||
|
(see the
|
||||||
.Fl s
|
.Fl s
|
||||||
option), or, failing that, use the
|
option), or, failing that, use the
|
||||||
.Fl M
|
.Fl M
|
||||||
flag to extract the package file, and inspect its contents and scripts
|
flag to extract the package file, and inspect its contents and scripts
|
||||||
to ensure it poses no danger to your system's integrity. Pay particular
|
to ensure it poses no danger to your system's integrity.
|
||||||
attention to any +INSTALL, +DEINSTALL, +REQUIRE or +MTREE_DIRS files,
|
Pay particular attention to any +INSTALL, +DEINSTALL, +REQUIRE
|
||||||
and inspect the +CONTENTS file for
|
or +MTREE_DIRS files, and inspect the +CONTENTS file for
|
||||||
.Cm @cwd ,
|
.Cm @cwd ,
|
||||||
.Cm @mode
|
.Cm @mode
|
||||||
(check for setuid),
|
(check for setuid),
|
||||||
|
@ -97,7 +98,8 @@ Any dependencies required by the installed package will be searched
|
||||||
in the same location that the original package was installed from.
|
in the same location that the original package was installed from.
|
||||||
.It Fl f
|
.It Fl f
|
||||||
Force installation to proceed even if prerequisite packages are not
|
Force installation to proceed even if prerequisite packages are not
|
||||||
installed or the requirements script fails. Although
|
installed or the requirements script fails.
|
||||||
|
Although
|
||||||
.Nm
|
.Nm
|
||||||
will still try to find and auto-install missing prerequisite packages,
|
will still try to find and auto-install missing prerequisite packages,
|
||||||
a failure to find one will not be fatal.
|
a failure to find one will not be fatal.
|
||||||
|
@ -106,11 +108,13 @@ If an installation script exists for a given package, do not execute it.
|
||||||
.It Fl M
|
.It Fl M
|
||||||
Run in
|
Run in
|
||||||
.Cm MASTER
|
.Cm MASTER
|
||||||
mode. This is a very specialized mode for running
|
mode.
|
||||||
|
This is a very specialized mode for running
|
||||||
.Nm
|
.Nm
|
||||||
and is meant to be run in conjunction with
|
and is meant to be run in conjunction with
|
||||||
.Cm SLAVE
|
.Cm SLAVE
|
||||||
mode. When run in this mode,
|
mode.
|
||||||
|
When run in this mode,
|
||||||
.Nm
|
.Nm
|
||||||
does no work beyond extracting the package into a temporary staging
|
does no work beyond extracting the package into a temporary staging
|
||||||
area (see the
|
area (see the
|
||||||
|
@ -131,15 +135,16 @@ Set
|
||||||
.Ar prefix
|
.Ar prefix
|
||||||
as the directory in which to extract files from a package.
|
as the directory in which to extract files from a package.
|
||||||
If a package has set its default directory, it will be overridden
|
If a package has set its default directory, it will be overridden
|
||||||
by this flag. Note that only the first
|
by this flag.
|
||||||
|
Note that only the first
|
||||||
.Cm @cwd
|
.Cm @cwd
|
||||||
directive will be replaced, since
|
directive will be replaced, since
|
||||||
.Nm
|
.Nm
|
||||||
has no way of knowing which directory settings are relative and
|
has no way of knowing which directory settings are relative and
|
||||||
which are absolute. It is rare in any case to see more than one
|
which are absolute.
|
||||||
directory transition made, but when such does happen and you wish
|
It is rare in any case to see more than one directory transition made,
|
||||||
to have control over *all* directory transitions, then you
|
but when such does happen and you wish to have control over *all* directory
|
||||||
may then wish to look into the use of
|
transitions, then you may then wish to look into the use of
|
||||||
.Cm MASTER
|
.Cm MASTER
|
||||||
and
|
and
|
||||||
.Cm SLAVE
|
.Cm SLAVE
|
||||||
|
@ -149,21 +154,24 @@ and
|
||||||
.Fl S
|
.Fl S
|
||||||
options).
|
options).
|
||||||
.It Fl R
|
.It Fl R
|
||||||
Do not record the installation of a package. This means
|
Do not record the installation of a package.
|
||||||
that you cannot deinstall it later, so only use this option if
|
This means that you cannot deinstall it later, so only use this option if
|
||||||
you know what you are doing!
|
you know what you are doing!
|
||||||
.It Fl S
|
.It Fl S
|
||||||
Run in
|
Run in
|
||||||
.Cm SLAVE
|
.Cm SLAVE
|
||||||
mode. This is a very specialized mode for running
|
mode.
|
||||||
|
This is a very specialized mode for running
|
||||||
.Nm
|
.Nm
|
||||||
and is meant to be run in conjunction with
|
and is meant to be run in conjunction with
|
||||||
.Cm MASTER
|
.Cm MASTER
|
||||||
mode. When run in this mode,
|
mode.
|
||||||
|
When run in this mode,
|
||||||
.Nm
|
.Nm
|
||||||
expects the release contents to be already extracted and waiting
|
expects the release contents to be already extracted and waiting
|
||||||
in the staging area, the location of which is read as a string
|
in the staging area, the location of which is read as a string
|
||||||
from stdin. The complete packing list is also read from stdin,
|
from stdin.
|
||||||
|
The complete packing list is also read from stdin,
|
||||||
and the contents then acted on as normal.
|
and the contents then acted on as normal.
|
||||||
.It Fl s Ar verification-type
|
.It Fl s Ar verification-type
|
||||||
Use a callout to an external program to verify the binary package
|
Use a callout to an external program to verify the binary package
|
||||||
|
@ -173,12 +181,12 @@ as the binary package.
|
||||||
At the present time, the following verification types
|
At the present time, the following verification types
|
||||||
are defined: none, gpg and pgp5.
|
are defined: none, gpg and pgp5.
|
||||||
The signature will be verified at install time, and the results
|
The signature will be verified at install time, and the results
|
||||||
will be displayed. If the signature type is anything other than
|
will be displayed.
|
||||||
none, the user will be asked if
|
If the signature type is anything other than none, the user will be asked if
|
||||||
.Nm
|
.Nm
|
||||||
should proceed to install the binary package. The user must then
|
should proceed to install the binary package.
|
||||||
take the decision whether to proceed or not, depending upon the
|
The user must then take the decision whether to proceed or not, depending
|
||||||
amount of trust that is placed in the signatory of the binary
|
upon the amount of trust that is placed in the signatory of the binary
|
||||||
package.
|
package.
|
||||||
Please note that, at the current time, it is not possible to use
|
Please note that, at the current time, it is not possible to use
|
||||||
the verification feature when using
|
the verification feature when using
|
||||||
|
@ -197,8 +205,8 @@ By default, this is the string
|
||||||
but it may be necessary to override it in the situation where
|
but it may be necessary to override it in the situation where
|
||||||
space in your
|
space in your
|
||||||
.Pa /var/tmp
|
.Pa /var/tmp
|
||||||
directory is limited. Be sure to leave some number of `X' characters
|
directory is limited.
|
||||||
for
|
Be sure to leave some number of `X' characters for
|
||||||
.Xr mktemp 3
|
.Xr mktemp 3
|
||||||
to fill in with a unique ID.
|
to fill in with a unique ID.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -221,8 +229,9 @@ One or more
|
||||||
.Ar pkg-name
|
.Ar pkg-name
|
||||||
arguments may be specified, each being either a file containing the
|
arguments may be specified, each being either a file containing the
|
||||||
package (these usually ending with the ``.tgz'' suffix) or a
|
package (these usually ending with the ``.tgz'' suffix) or a
|
||||||
URL pointing at a file available on an ftp or web site. Thus you may
|
URL pointing at a file available on an ftp or web site.
|
||||||
extract files directly from their anonymous ftp or WWW locations (e.g.
|
Thus you may extract files directly from their anonymous ftp or WWW
|
||||||
|
locations (e.g.
|
||||||
.Nm
|
.Nm
|
||||||
ftp://ftp.netbsd.org/pub/NetBSD/packages/1.5/i386/shells/bash-2.04.tgz).
|
ftp://ftp.netbsd.org/pub/NetBSD/packages/1.5/i386/shells/bash-2.04.tgz).
|
||||||
Note: If you wish to use
|
Note: If you wish to use
|
||||||
|
@ -234,8 +243,9 @@ the variable
|
||||||
.Bf -emphasis
|
.Bf -emphasis
|
||||||
FTP_PASSIVE_MODE
|
FTP_PASSIVE_MODE
|
||||||
.Ef
|
.Ef
|
||||||
to some value in your environment. Otherwise, the more standard
|
to some value in your environment.
|
||||||
ACTIVE mode may be used. If
|
Otherwise, the more standard ACTIVE mode may be used.
|
||||||
|
If
|
||||||
.Nm
|
.Nm
|
||||||
consistently fails to fetch a package from a site known to work,
|
consistently fails to fetch a package from a site known to work,
|
||||||
it may be because you have a firewall that demands the usage of
|
it may be because you have a firewall that demands the usage of
|
||||||
|
@ -265,7 +275,8 @@ This is prepared by moving an existing
|
||||||
.Pa +REQUIRED_BY
|
.Pa +REQUIRED_BY
|
||||||
file aside (if it exists), and by running
|
file aside (if it exists), and by running
|
||||||
.Xr pkg_delete 1
|
.Xr pkg_delete 1
|
||||||
on the installed package. Installation then procedes as if the package
|
on the installed package.
|
||||||
|
Installation then proceeds as if the package
|
||||||
was not installed, and restores the
|
was not installed, and restores the
|
||||||
.Pa +REQUIRED_BY
|
.Pa +REQUIRED_BY
|
||||||
file afterwards.
|
file afterwards.
|
||||||
|
@ -274,8 +285,8 @@ A check is made to determine if the package conflicts (from
|
||||||
.Cm @pkgcfl
|
.Cm @pkgcfl
|
||||||
directives, see
|
directives, see
|
||||||
.Xr pkg_create 1 )
|
.Xr pkg_create 1 )
|
||||||
with an already recorded as installed package. If it is,
|
with an already recorded as installed package.
|
||||||
installation is terminated.
|
If it is, installation is terminated.
|
||||||
.It
|
.It
|
||||||
All package dependencies (from
|
All package dependencies (from
|
||||||
.Cm @pkgdep
|
.Cm @pkgdep
|
||||||
|
@ -405,7 +416,8 @@ scripts are called with the environment variable
|
||||||
.Ev PKG_PREFIX
|
.Ev PKG_PREFIX
|
||||||
set to the installation prefix (see the
|
set to the installation prefix (see the
|
||||||
.Fl p
|
.Fl p
|
||||||
option above). This allows a package author to write a script
|
option above).
|
||||||
|
This allows a package author to write a script
|
||||||
that reliably performs some action on the directory where the package
|
that reliably performs some action on the directory where the package
|
||||||
is installed, even if the user might change it with the
|
is installed, even if the user might change it with the
|
||||||
.Fl p
|
.Fl p
|
||||||
|
@ -418,10 +430,11 @@ The value of the
|
||||||
is used if a given package can't be found, it's usually set to
|
is used if a given package can't be found, it's usually set to
|
||||||
.Pa /usr/pkgsrc/packages/All .
|
.Pa /usr/pkgsrc/packages/All .
|
||||||
The environment variable
|
The environment variable
|
||||||
should be a series of entries separated by semicolons. Each entry
|
should be a series of entries separated by semicolons.
|
||||||
consists of a directory name or URL. The current directory may be indicated
|
Each entry consists of a directory name or URL.
|
||||||
implicitly by an empty directory name, or explicitly by a single
|
The current directory may be indicated implicitly by an empty directory
|
||||||
period. FTP URLs may not end with a slash.
|
name, or explicitly by a single period.
|
||||||
|
FTP URLs may not end with a slash.
|
||||||
.Ss PKG_DBDIR
|
.Ss PKG_DBDIR
|
||||||
Where to register packages instead of
|
Where to register packages instead of
|
||||||
.Pa /var/db/pkg .
|
.Pa /var/db/pkg .
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
.\" $NetBSD: pkg_admin.1,v 1.19 2002/09/25 00:34:44 wiz Exp $
|
.\" $NetBSD: pkg_admin.1,v 1.20 2002/09/26 01:41:51 wiz Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" Copyright (c) 1999-2002 Hubert Feyrer. All rights reserved.
|
.\" Copyright (c) 1999-2002 Hubert Feyrer. All rights reserved.
|
||||||
.\"
|
.\"
|
||||||
|
@ -41,7 +41,8 @@
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
This command performs various administrative tasks around the
|
This command performs various administrative tasks around the
|
||||||
.Nx
|
.Nx
|
||||||
Packages System. Available commands are:
|
Packages System.
|
||||||
|
Available commands are:
|
||||||
.Pp
|
.Pp
|
||||||
.Bl -tag -width check
|
.Bl -tag -width check
|
||||||
.It Fl V
|
.It Fl V
|
||||||
|
@ -49,15 +50,16 @@ Print version number and exit.
|
||||||
.It Cm check Op Ar pkg ...
|
.It Cm check Op Ar pkg ...
|
||||||
Use this command to check the files belonging to some or all of the
|
Use this command to check the files belonging to some or all of the
|
||||||
packages installed on the local machine against their MD5 checksum
|
packages installed on the local machine against their MD5 checksum
|
||||||
noted in their +CONTENTS files. If no additional argument is given,
|
noted in their +CONTENTS files.
|
||||||
the files of all installed packages are checked, else only the named
|
If no additional argument is given, the files of all installed packages
|
||||||
packages will be checked (wildcards can be used here, see
|
are checked, else only the named packages will be checked (wildcards can
|
||||||
|
be used here, see
|
||||||
.Xr pkg_info 1 ) .
|
.Xr pkg_info 1 ) .
|
||||||
.Pp
|
.Pp
|
||||||
The packages' +CONTENTS files will be parsed and the MD5
|
The packages' +CONTENTS files will be parsed and the MD5
|
||||||
checksum will be checked for every file found. A warning message is
|
checksum will be checked for every file found.
|
||||||
printed if the expected checksum differs from the checksum of the file
|
A warning message is printed if the expected checksum differs from the
|
||||||
on disk.
|
checksum of the file on disk.
|
||||||
.Pp
|
.Pp
|
||||||
.It Cm dump
|
.It Cm dump
|
||||||
Dump the contents of the package database, similar to
|
Dump the contents of the package database, similar to
|
||||||
|
@ -68,9 +70,11 @@ and the data field - the package the file belongs to.
|
||||||
.It Cm lsbest /dir/pkgpattern
|
.It Cm lsbest /dir/pkgpattern
|
||||||
List all/best package matching pattern in the given directory.
|
List all/best package matching pattern in the given directory.
|
||||||
Can be used to work around limitations of /bin/sh and other
|
Can be used to work around limitations of /bin/sh and other
|
||||||
filename globbing mechanisms. This option implements matching of
|
filename globbing mechanisms.
|
||||||
|
This option implements matching of
|
||||||
pkg-wildcards against arbitrary files, useful mainly in the build
|
pkg-wildcards against arbitrary files, useful mainly in the build
|
||||||
system itself. See
|
system itself.
|
||||||
|
See
|
||||||
.Xr pkg_info 1
|
.Xr pkg_info 1
|
||||||
for a description of the pattern.
|
for a description of the pattern.
|
||||||
.Pp
|
.Pp
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
.\" $NetBSD: pkg_create.1,v 1.33 2002/09/24 03:18:01 uebayasi Exp $
|
.\" $NetBSD: pkg_create.1,v 1.34 2002/09/26 01:41:51 wiz Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" FreeBSD install - a package for the installation and maintainance
|
.\" FreeBSD install - a package for the installation and maintenance
|
||||||
.\" of non-core utilities.
|
.\" of non-core utilities.
|
||||||
.\"
|
.\"
|
||||||
.\" Redistribution and use in source and binary forms, with or without
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
|
@ -98,12 +98,14 @@
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
command is used to create packages that will subsequently be fed to
|
command is used to create packages that will subsequently be fed to
|
||||||
one of the package extraction/info utilities. The input description
|
one of the package extraction/info utilities.
|
||||||
and command line arguments for the creation of a package are not
|
The input description and command line arguments for the creation of a
|
||||||
really meant to be human-generated, though it is easy enough to
|
package are not really meant to be human-generated, though it is easy
|
||||||
do so. It is more expected that you will use a front-end tool for
|
enough to do so.
|
||||||
the job rather than muddling through it yourself. Nonetheless, a short
|
It is more expected that you will use a front-end tool for
|
||||||
description of the input syntax is included in this document.
|
the job rather than muddling through it yourself.
|
||||||
|
Nonetheless, a short description of the input syntax is included in this
|
||||||
|
document.
|
||||||
.Sh OPTIONS
|
.Sh OPTIONS
|
||||||
The following command line options are supported:
|
The following command line options are supported:
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
|
@ -114,18 +116,18 @@ so that users of binary packages can see what
|
||||||
.Xr make 1
|
.Xr make 1
|
||||||
definitions
|
definitions
|
||||||
were used to control the build when creating the
|
were used to control the build when creating the
|
||||||
binary package. This allows various build definitions
|
binary package.
|
||||||
to be retained in a binary package and viewed wherever it is installed,
|
This allows various build definitions to be retained in a binary package
|
||||||
using
|
and viewed wherever it is installed, using
|
||||||
.Xr pkg_info 1 .
|
.Xr pkg_info 1 .
|
||||||
.It Fl b Ar build-version-file
|
.It Fl b Ar build-version-file
|
||||||
Install the file
|
Install the file
|
||||||
.Ar build-version-file
|
.Ar build-version-file
|
||||||
so that users of binary packages can see what versions of
|
so that users of binary packages can see what versions of
|
||||||
the files used to control the build were used when creating the
|
the files used to control the build were used when creating the
|
||||||
binary package. This allows some fine-grained version control information
|
binary package.
|
||||||
to be retained in a binary package and viewed wherever it is installed,
|
This allows some fine-grained version control information to be retained
|
||||||
using
|
in a binary package and viewed wherever it is installed, using
|
||||||
.Xr pkg_info 1 .
|
.Xr pkg_info 1 .
|
||||||
.It Fl C Ar cpkgs
|
.It Fl C Ar cpkgs
|
||||||
Set the initial package conflict list to
|
Set the initial package conflict list to
|
||||||
|
@ -139,12 +141,12 @@ Fetch package ``one line description'' from file
|
||||||
.Ar desc
|
.Ar desc
|
||||||
or, if preceded by
|
or, if preceded by
|
||||||
.Cm - ,
|
.Cm - ,
|
||||||
the argument itself. This string should also
|
the argument itself.
|
||||||
give some idea of which version of the product (if any) the package
|
This string should also give some idea of which version of the product
|
||||||
represents.
|
(if any) the package represents.
|
||||||
.It Fl D Ar displayfile
|
.It Fl D Ar displayfile
|
||||||
Display the file after installing the package. Useful for things like
|
Display the file after installing the package.
|
||||||
legal notices on almost-free software, etc.
|
Useful for things like legal notices on almost-free software, etc.
|
||||||
.It Fl d Ar [-]desc
|
.It Fl d Ar [-]desc
|
||||||
Fetch long description for package from file
|
Fetch long description for package from file
|
||||||
.Ar desc
|
.Ar desc
|
||||||
|
@ -170,26 +172,28 @@ staged installations of packages.
|
||||||
.It Fl i Ar iscript
|
.It Fl i Ar iscript
|
||||||
Set
|
Set
|
||||||
.Ar iscript
|
.Ar iscript
|
||||||
to be the install procedure for the package. This can be any
|
to be the install procedure for the package.
|
||||||
executable program (or shell script). It will be invoked automatically
|
This can be any executable program (or shell script).
|
||||||
when the package is later installed.
|
It will be invoked automatically when the package is later installed.
|
||||||
.It Fl k Ar dscript
|
.It Fl k Ar dscript
|
||||||
Set
|
Set
|
||||||
.Ar dscript
|
.Ar dscript
|
||||||
to be the de-install procedure for the package. This can be any
|
to be the de-install procedure for the package.
|
||||||
executable program (or shell script). It will be invoked automatically
|
This can be any executable program (or shell script).
|
||||||
|
It will be invoked automatically
|
||||||
when the package is later (if ever) de-installed.
|
when the package is later (if ever) de-installed.
|
||||||
.It Fl L Ar SrcDir
|
.It Fl L Ar SrcDir
|
||||||
This sets the package's @src directive; see below for a description
|
This sets the package's @src directive; see below for a description
|
||||||
of what this does.
|
of what this does.
|
||||||
.It Fl l
|
.It Fl l
|
||||||
Check that any symbolic links which are to be placed in the package are
|
Check that any symbolic links which are to be placed in the package are
|
||||||
relative to the current prefix. This means using
|
relative to the current prefix.
|
||||||
|
This means using
|
||||||
.Xr unlink 2
|
.Xr unlink 2
|
||||||
and
|
and
|
||||||
.Xr symlink 2
|
.Xr symlink 2
|
||||||
to remove and re-link
|
to remove and re-link
|
||||||
any symbolic links which are targetted at full path names.
|
any symbolic links which are targeted at full path names.
|
||||||
.It Fl m Ar mtreefile
|
.It Fl m Ar mtreefile
|
||||||
Run
|
Run
|
||||||
.Xr mtree 8
|
.Xr mtree 8
|
||||||
|
@ -237,22 +241,24 @@ parent directories.
|
||||||
.It Fl r Ar rscript
|
.It Fl r Ar rscript
|
||||||
Set
|
Set
|
||||||
.Ar rscript
|
.Ar rscript
|
||||||
to be the ``requirements'' procedure for the package. This can be any
|
to be the ``requirements'' procedure for the package.
|
||||||
executable program (or shell script). It will be invoked automatically
|
This can be any executable program (or shell script).
|
||||||
at installation/deinstallation time to determine whether or not
|
It will be invoked automatically at installation/deinstallation time to
|
||||||
installation/deinstallation should proceed.
|
determine whether or not installation/deinstallation should proceed.
|
||||||
.It Fl S Ar size-all-file
|
.It Fl S Ar size-all-file
|
||||||
Store the given file for later querying with the
|
Store the given file for later querying with the
|
||||||
.Xr pkg_info 1
|
.Xr pkg_info 1
|
||||||
.Ar -S
|
.Ar -S
|
||||||
flag. The file is expected to contain the size (in bytes) of all files of
|
flag.
|
||||||
|
The file is expected to contain the size (in bytes) of all files of
|
||||||
this package plus any required packages added up and stored as a
|
this package plus any required packages added up and stored as a
|
||||||
ASCII string, terminated by a newline.
|
ASCII string, terminated by a newline.
|
||||||
.It Fl s Ar size-pkg-file
|
.It Fl s Ar size-pkg-file
|
||||||
Store the given file for later querying with the
|
Store the given file for later querying with the
|
||||||
.Xr pkg_info 1
|
.Xr pkg_info 1
|
||||||
.Ar -s
|
.Ar -s
|
||||||
flag. The file is expected to contain the the size (in bytes) of all files of
|
flag.
|
||||||
|
The file is expected to contain the the size (in bytes) of all files of
|
||||||
this package added up and stored as a ASCII string, terminated by a newline.
|
this package added up and stored as a ASCII string, terminated by a newline.
|
||||||
.It Fl t Ar template
|
.It Fl t Ar template
|
||||||
Use
|
Use
|
||||||
|
@ -264,8 +270,8 @@ By default, this is the string
|
||||||
but it may be necessary to override it in the situation where
|
but it may be necessary to override it in the situation where
|
||||||
space in your
|
space in your
|
||||||
.Pa /tmp
|
.Pa /tmp
|
||||||
directory is limited. Be sure to leave some number of `X' characters
|
directory is limited.
|
||||||
for
|
Be sure to leave some number of `X' characters for
|
||||||
.Xr mktemp 3
|
.Xr mktemp 3
|
||||||
to fill in with a unique ID.
|
to fill in with a unique ID.
|
||||||
.It Fl U
|
.It Fl U
|
||||||
|
@ -281,7 +287,8 @@ as a
|
||||||
.Fl -exclude-from
|
.Fl -exclude-from
|
||||||
argument to
|
argument to
|
||||||
.Cm tar
|
.Cm tar
|
||||||
when creating final package. See
|
when creating final package.
|
||||||
|
See
|
||||||
.Cm tar
|
.Cm tar
|
||||||
man page (or run
|
man page (or run
|
||||||
.Cm tar
|
.Cm tar
|
||||||
|
@ -294,12 +301,15 @@ The ``packing list'' format (see
|
||||||
.Fl f )
|
.Fl f )
|
||||||
is fairly simple, being
|
is fairly simple, being
|
||||||
nothing more than a single column of filenames to include in the
|
nothing more than a single column of filenames to include in the
|
||||||
package. However, since absolute pathnames are generally a bad idea
|
package.
|
||||||
|
However, since absolute pathnames are generally a bad idea
|
||||||
for a package that could be installed potentially anywhere, there is
|
for a package that could be installed potentially anywhere, there is
|
||||||
another method of specifying where things are supposed to go
|
another method of specifying where things are supposed to go
|
||||||
and, optionally, what ownership and mode information they should be
|
and, optionally, what ownership and mode information they should be
|
||||||
installed with. This is done by imbeding specialized command sequences
|
installed with.
|
||||||
in the packing list. Briefly described, these sequences are:
|
This is done by embedding specialized command sequences
|
||||||
|
in the packing list.
|
||||||
|
Briefly described, these sequences are:
|
||||||
.Bl -tag -width indent -compact
|
.Bl -tag -width indent -compact
|
||||||
.It Cm @cwd Ar directory
|
.It Cm @cwd Ar directory
|
||||||
Set the internal directory pointer to point to
|
Set the internal directory pointer to point to
|
||||||
|
@ -317,10 +327,12 @@ for package creation but not extraction.
|
||||||
.It Cm @exec Ar command
|
.It Cm @exec Ar command
|
||||||
Execute
|
Execute
|
||||||
.Ar command
|
.Ar command
|
||||||
as part of the unpacking process. If
|
as part of the unpacking process.
|
||||||
|
If
|
||||||
.Ar command
|
.Ar command
|
||||||
contains any of the following sequences somewhere in it, they will
|
contains any of the following sequences somewhere in it, they will
|
||||||
be expanded inline. For the following examples, assume that
|
be expanded inline.
|
||||||
|
For the following examples, assume that
|
||||||
.Cm @cwd
|
.Cm @cwd
|
||||||
is set to
|
is set to
|
||||||
.Pa /usr/local
|
.Pa /usr/local
|
||||||
|
@ -338,7 +350,8 @@ in the example case
|
||||||
.It Cm "%B"
|
.It Cm "%B"
|
||||||
Expand to the ``basename'' of the fully qualified filename, that
|
Expand to the ``basename'' of the fully qualified filename, that
|
||||||
is the current directory prefix, plus the last filespec, minus
|
is the current directory prefix, plus the last filespec, minus
|
||||||
the trailing filename. In the example case, that would be
|
the trailing filename.
|
||||||
|
In the example case, that would be
|
||||||
.Pa /usr/local/bin .
|
.Pa /usr/local/bin .
|
||||||
.It Cm "%f"
|
.It Cm "%f"
|
||||||
Expand to the ``filename'' part of the fully qualified name, or
|
Expand to the ``filename'' part of the fully qualified name, or
|
||||||
|
@ -350,17 +363,18 @@ being in the example case,
|
||||||
.It Cm @unexec Ar command
|
.It Cm @unexec Ar command
|
||||||
Execute
|
Execute
|
||||||
.Ar command
|
.Ar command
|
||||||
as part of the deinstallation process. Expansion of special
|
as part of the deinstallation process.
|
||||||
|
Expansion of special
|
||||||
.Cm %
|
.Cm %
|
||||||
sequences is the same as for
|
sequences is the same as for
|
||||||
.Cm @exec .
|
.Cm @exec .
|
||||||
This command is not executed during the package add, as
|
This command is not executed during the package add, as
|
||||||
.Cm @exec
|
.Cm @exec
|
||||||
is, but rather when the package is deleted. This is useful
|
is, but rather when the package is deleted.
|
||||||
for deleting links and other ancillary files that were created
|
This is useful for deleting links and other ancillary files that were created
|
||||||
as a result of adding the package, but not directly known to
|
as a result of adding the package, but not directly known to the package's
|
||||||
the package's table of contents (and hence not automatically
|
table of contents (and hence not automatically removable).
|
||||||
removable). The advantage of using
|
The advantage of using
|
||||||
.Cm @unexec
|
.Cm @unexec
|
||||||
over a deinstallation script is that you can use the ``special
|
over a deinstallation script is that you can use the ``special
|
||||||
sequence expansion'' to get at files regardless of where they've
|
sequence expansion'' to get at files regardless of where they've
|
||||||
|
@ -372,8 +386,8 @@ Set default permission for all subsequently extracted files to
|
||||||
Format is the same as that used by the
|
Format is the same as that used by the
|
||||||
.Cm chmod
|
.Cm chmod
|
||||||
command (well, considering that it's later handed off to it, that's
|
command (well, considering that it's later handed off to it, that's
|
||||||
no surprise). Use without an arg to set back to default (extraction)
|
no surprise).
|
||||||
permissions.
|
Use without an arg to set back to default (extraction) permissions.
|
||||||
.It Cm @option Ar option
|
.It Cm @option Ar option
|
||||||
Set internal package options, the only two currently supported ones
|
Set internal package options, the only two currently supported ones
|
||||||
being
|
being
|
||||||
|
@ -397,8 +411,8 @@ Set default group ownership for all subsequently extracted files to
|
||||||
Use without an arg to set back to default (extraction)
|
Use without an arg to set back to default (extraction)
|
||||||
group ownership.
|
group ownership.
|
||||||
.It Cm @comment Ar string
|
.It Cm @comment Ar string
|
||||||
Imbed a comment in the packing list. Useful in
|
Imbed a comment in the packing list.
|
||||||
trying to document some particularly hairy sequence that
|
Useful in trying to document some particularly hairy sequence that
|
||||||
may trip someone up later.
|
may trip someone up later.
|
||||||
.It Cm @ignore
|
.It Cm @ignore
|
||||||
Used internally to tell extraction to ignore the next file (don't
|
Used internally to tell extraction to ignore the next file (don't
|
||||||
|
@ -406,27 +420,30 @@ copy it anywhere), as it's used for some special purpose.
|
||||||
.It Cm @ignore_inst
|
.It Cm @ignore_inst
|
||||||
Similar to
|
Similar to
|
||||||
.Cm @ignore ,
|
.Cm @ignore ,
|
||||||
but the ignoring of the next file is delayed one evaluation cycle. This
|
but the ignoring of the next file is delayed one evaluation cycle.
|
||||||
makes it possible to use this directive in the
|
This makes it possible to use this directive in the
|
||||||
.Ar packinglist
|
.Ar packinglist
|
||||||
file, so you can pack a
|
file, so you can pack a
|
||||||
specialized datafile in with a distribution for your install script (or
|
specialized datafile in with a distribution for your install script (or
|
||||||
something) yet have the installer ignore it.
|
something) yet have the installer ignore it.
|
||||||
.It Cm @name Ar name
|
.It Cm @name Ar name
|
||||||
Set the name of the package. This is mandatory and is usually
|
Set the name of the package.
|
||||||
put at the top. This name is potentially different than the name of
|
This is mandatory and is usually put at the top.
|
||||||
the file it came in, and is used when keeping track of the package
|
This name is potentially different than the name of the file it came in,
|
||||||
for later deinstallation. Note that
|
and is used when keeping track of the package for later deinstallation.
|
||||||
|
Note that
|
||||||
.Nm
|
.Nm
|
||||||
will derive this field from the package name and add it automatically
|
will derive this field from the package name and add it automatically
|
||||||
if none is given.
|
if none is given.
|
||||||
.It Cm @dirrm Ar name
|
.It Cm @dirrm Ar name
|
||||||
Declare directory
|
Declare directory
|
||||||
.Pa name
|
.Pa name
|
||||||
to be deleted at deinstall time. By default, directories created by a
|
to be deleted at deinstall time.
|
||||||
package installation are not deleted when the package is deinstalled;
|
By default, directories created by a package installation are not deleted
|
||||||
this provides an explicit directory cleanup method. This directive
|
when the package is deinstalled; this provides an explicit directory cleanup
|
||||||
should appear at the end of the package list. If more than one
|
method.
|
||||||
|
This directive should appear at the end of the package list.
|
||||||
|
If more than one
|
||||||
.Cm @dirrm
|
.Cm @dirrm
|
||||||
directives are used, the directories are removed in the order specified.
|
directives are used, the directories are removed in the order specified.
|
||||||
The
|
The
|
||||||
|
@ -439,7 +456,8 @@ as an
|
||||||
.Xr mtree 8
|
.Xr mtree 8
|
||||||
input file to be used at install time (see
|
input file to be used at install time (see
|
||||||
.Fl m
|
.Fl m
|
||||||
above). Only the first
|
above).
|
||||||
|
Only the first
|
||||||
.Cm @mtree
|
.Cm @mtree
|
||||||
directive is honored.
|
directive is honored.
|
||||||
.It Cm @display Ar name
|
.It Cm @display Ar name
|
||||||
|
@ -451,12 +469,14 @@ above).
|
||||||
.It Cm @pkgdep Ar pkgname
|
.It Cm @pkgdep Ar pkgname
|
||||||
Declare a dependency on the
|
Declare a dependency on the
|
||||||
.Ar pkgname
|
.Ar pkgname
|
||||||
package. The
|
package.
|
||||||
|
The
|
||||||
.Ar pkgname
|
.Ar pkgname
|
||||||
package must be installed before this package may be
|
package must be installed before this package may be
|
||||||
installed, and this package must be deinstalled before the
|
installed, and this package must be deinstalled before the
|
||||||
.Ar pkgname
|
.Ar pkgname
|
||||||
package is deinstalled. Multiple
|
package is deinstalled.
|
||||||
|
Multiple
|
||||||
.Cm @pkgdep
|
.Cm @pkgdep
|
||||||
directives may be used if the package depends on multiple other packages.
|
directives may be used if the package depends on multiple other packages.
|
||||||
.It Cm @blddep Ar pkgname
|
.It Cm @blddep Ar pkgname
|
||||||
|
@ -500,7 +520,8 @@ wildcard dependency processing, pkgdb, pkg size recording etc.
|
||||||
Hard links between files in a distribution must be bracketed by
|
Hard links between files in a distribution must be bracketed by
|
||||||
.Cm @cwd
|
.Cm @cwd
|
||||||
directives in order to be preserved as hard links when the package is
|
directives in order to be preserved as hard links when the package is
|
||||||
extracted. They additionally must not end up being split between
|
extracted.
|
||||||
|
They additionally must not end up being split between
|
||||||
.Cm tar
|
.Cm tar
|
||||||
invocations due to exec argument-space limitations (this depends on the
|
invocations due to exec argument-space limitations (this depends on the
|
||||||
value returned by
|
value returned by
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
.\" $NetBSD: pkg_delete.1,v 1.25 2002/09/24 03:18:01 uebayasi Exp $
|
.\" $NetBSD: pkg_delete.1,v 1.26 2002/09/26 01:41:51 wiz Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" FreeBSD install - a package for the installation and maintainance
|
.\" FreeBSD install - a package for the installation and maintenance
|
||||||
.\" of non-core utilities.
|
.\" of non-core utilities.
|
||||||
.\"
|
.\"
|
||||||
.\" Redistribution and use in source and binary forms, with or without
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
|
@ -42,13 +42,14 @@ command.
|
||||||
Since the
|
Since the
|
||||||
.Nm
|
.Nm
|
||||||
command may execute scripts or programs provided by a package file,
|
command may execute scripts or programs provided by a package file,
|
||||||
your system may be susceptible to ``trojan horses'' or other subtle
|
your system may be susceptible to ``Trojan horses'' or other subtle
|
||||||
attacks from miscreants who create dangerous package files.
|
attacks from miscreants who create dangerous package files.
|
||||||
.Pp
|
.Pp
|
||||||
You are advised to verify the competence and identity of those who
|
You are advised to verify the competence and identity of those who
|
||||||
provide installable package files. For extra protection, examine all
|
provide installable package files.
|
||||||
the package control files in the package record directory (
|
For extra protection, examine all the package control files in the
|
||||||
.Pa /var/db/pkg/\*[Lt]pkg-name\*[Gt]/ ) .
|
package record directory
|
||||||
|
.Pa ( /var/db/pkg/\*[Lt]pkg-name\*[Gt]/ ) .
|
||||||
Pay particular
|
Pay particular
|
||||||
attention to any +INSTALL, +DEINSTALL, +REQUIRE or +MTREE_DIRS files,
|
attention to any +INSTALL, +DEINSTALL, +REQUIRE or +MTREE_DIRS files,
|
||||||
and inspect the +CONTENTS file for
|
and inspect the +CONTENTS file for
|
||||||
|
@ -75,22 +76,25 @@ If the
|
||||||
.Fl F
|
.Fl F
|
||||||
flag is given, one or more (absolute) filenames may be specified and
|
flag is given, one or more (absolute) filenames may be specified and
|
||||||
the Package Database will be consulted for the package to which the
|
the Package Database will be consulted for the package to which the
|
||||||
given file belongs. These packages are then deinstalled.
|
given file belongs.
|
||||||
|
These packages are then deinstalled.
|
||||||
.It Fl D
|
.It Fl D
|
||||||
If a deinstallation script exists for a given package, do not execute it.
|
If a deinstallation script exists for a given package, do not execute it.
|
||||||
.It Fl d
|
.It Fl d
|
||||||
Remove empty directories created by file cleanup. By default, only
|
Remove empty directories created by file cleanup.
|
||||||
files/directories explicitly listed in a package's contents (either as
|
By default, only files/directories explicitly listed in a package's
|
||||||
normal files/directories or with the
|
contents (either as normal files/directories or with the
|
||||||
.Cm @dirrm
|
.Cm @dirrm
|
||||||
directive) will be removed at deinstallation time. This option tells
|
directive) will be removed at deinstallation time.
|
||||||
|
This option tells
|
||||||
.Nm
|
.Nm
|
||||||
to also remove any directories that were emptied as a result of removing
|
to also remove any directories that were emptied as a result of removing
|
||||||
the package.
|
the package.
|
||||||
.It Fl F
|
.It Fl F
|
||||||
Any pkg-name given will be interpreted as pathname which is
|
Any pkg-name given will be interpreted as pathname which is
|
||||||
subsequently transformed in a (real) package name via the Package
|
subsequently transformed in a (real) package name via the Package
|
||||||
Database. That way, packges can be deleted by giving a filename
|
Database.
|
||||||
|
That way, packages can be deleted by giving a filename
|
||||||
instead of the package-name.
|
instead of the package-name.
|
||||||
.It Fl f
|
.It Fl f
|
||||||
Force removal of the package, even if a dependency is recorded or the
|
Force removal of the package, even if a dependency is recorded or the
|
||||||
|
@ -105,21 +109,24 @@ touch the package or its files itself.
|
||||||
Set
|
Set
|
||||||
.Ar prefix
|
.Ar prefix
|
||||||
as the directory in which to delete files from any installed packages
|
as the directory in which to delete files from any installed packages
|
||||||
which do not explicitly set theirs. For most packages, the prefix will
|
which do not explicitly set theirs.
|
||||||
|
For most packages, the prefix will
|
||||||
be set automatically to the installed location by
|
be set automatically to the installed location by
|
||||||
.Xr pkg_add 1 .
|
.Xr pkg_add 1 .
|
||||||
.It Fl R
|
.It Fl R
|
||||||
Like the
|
Like the
|
||||||
.Fl r
|
.Fl r
|
||||||
option, this does a recursive delete. The
|
option, this does a recursive delete.
|
||||||
|
The
|
||||||
.Fl R
|
.Fl R
|
||||||
option deletes the given package and any packages required by
|
option deletes the given package and any packages required by
|
||||||
it, unless some other package still needs them. This can be used
|
it, unless some other package still needs them.
|
||||||
to delete a package and all the packages it needs.
|
This can be used to delete a package and all the packages it needs.
|
||||||
.It Fl r
|
.It Fl r
|
||||||
.Nm
|
.Nm
|
||||||
first builds a list of all packages that require (directly and indirectly)
|
first builds a list of all packages that require (directly and indirectly)
|
||||||
the one being deleted. It then deletes these packages using
|
the one being deleted.
|
||||||
|
It then deletes these packages using
|
||||||
.Nm
|
.Nm
|
||||||
with the given options before deleting the user specified package.
|
with the given options before deleting the user specified package.
|
||||||
.It Fl V
|
.It Fl V
|
||||||
|
@ -129,7 +136,8 @@ Turn on verbose output.
|
||||||
.El
|
.El
|
||||||
.Sh TECHNICAL DETAILS
|
.Sh TECHNICAL DETAILS
|
||||||
.Nm
|
.Nm
|
||||||
does pretty much what it says. It examines installed package records in
|
does pretty much what it says.
|
||||||
|
It examines installed package records in
|
||||||
.Pa /var/db/pkg/\*[Lt]pkg-name\*[Gt] ,
|
.Pa /var/db/pkg/\*[Lt]pkg-name\*[Gt] ,
|
||||||
deletes the package contents, and finally removes the package records.
|
deletes the package contents, and finally removes the package records.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -143,8 +151,8 @@ option is given).
|
||||||
If a filename is given instead of a package name, the package of which
|
If a filename is given instead of a package name, the package of which
|
||||||
the given file belongs to can be deleted if the
|
the given file belongs to can be deleted if the
|
||||||
.Fl F
|
.Fl F
|
||||||
Flag is given. The filename needs to be absolute, see the output
|
Flag is given.
|
||||||
produced by the pkg_info
|
The filename needs to be absolute, see the output produced by the pkg_info
|
||||||
.Fl aF
|
.Fl aF
|
||||||
command.
|
command.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -163,8 +171,8 @@ then this is executed first as
|
||||||
is the name of the package in question and
|
is the name of the package in question and
|
||||||
.Ar DEINSTALL
|
.Ar DEINSTALL
|
||||||
is a keyword denoting that this is a deinstallation)
|
is a keyword denoting that this is a deinstallation)
|
||||||
to see whether or not deinstallation should continue. A non-zero exit
|
to see whether or not deinstallation should continue.
|
||||||
status means no, unless the
|
A non-zero exit status means no, unless the
|
||||||
.Fl f
|
.Fl f
|
||||||
option is specified.
|
option is specified.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -190,7 +198,8 @@ before deleting all files and as:
|
||||||
.Ar \*[Lt]pkg-name\*[Gt]
|
.Ar \*[Lt]pkg-name\*[Gt]
|
||||||
.Ar POST-DEINSTALL
|
.Ar POST-DEINSTALL
|
||||||
.Ed
|
.Ed
|
||||||
after deleting them. Passing the keywords
|
after deleting them.
|
||||||
|
Passing the keywords
|
||||||
.Ar DEINSTALL
|
.Ar DEINSTALL
|
||||||
and
|
and
|
||||||
.Ar POST-DEINSTALL
|
.Ar POST-DEINSTALL
|
||||||
|
@ -201,7 +210,8 @@ All scripts are called with the environment variable
|
||||||
.Ev PKG_PREFIX
|
.Ev PKG_PREFIX
|
||||||
set to the installation prefix (see the
|
set to the installation prefix (see the
|
||||||
.Fl p
|
.Fl p
|
||||||
option above). This allows a package author to write a script
|
option above).
|
||||||
|
This allows a package author to write a script
|
||||||
that reliably performs some action on the directory where the package
|
that reliably performs some action on the directory where the package
|
||||||
is installed, even if the user might have changed it by specifying the
|
is installed, even if the user might have changed it by specifying the
|
||||||
.Fl p
|
.Fl p
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
.\" $NetBSD: pkg_info.1,v 1.30 2002/09/24 03:18:01 uebayasi Exp $
|
.\" $NetBSD: pkg_info.1,v 1.31 2002/09/26 01:41:51 wiz Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" FreeBSD install - a package for the installation and maintainance
|
.\" FreeBSD install - a package for the installation and maintenance
|
||||||
.\" of non-core utilities.
|
.\" of non-core utilities.
|
||||||
.\"
|
.\"
|
||||||
.\" Redistribution and use in source and binary forms, with or without
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
|
@ -68,9 +68,9 @@ the binary package (the "Build information") for each package.
|
||||||
Show the
|
Show the
|
||||||
.Nx
|
.Nx
|
||||||
RCS Id strings from the files used in the construction
|
RCS Id strings from the files used in the construction
|
||||||
of the binary package (the "Build version") for each package. These files are the
|
of the binary package (the "Build version") for each package.
|
||||||
package Makefile, any patch files, any checksum files, and the packing
|
These files are the package Makefile, any patch files, any checksum
|
||||||
list file.
|
files, and the packing list file.
|
||||||
.It Fl c
|
.It Fl c
|
||||||
Show the one-line comment field for each package.
|
Show the one-line comment field for each package.
|
||||||
.It Fl D
|
.It Fl D
|
||||||
|
@ -92,7 +92,7 @@ option.
|
||||||
If the given
|
If the given
|
||||||
.Ar pkg-name
|
.Ar pkg-name
|
||||||
contains a
|
contains a
|
||||||
shell metacharacter, it will be matched against all installed
|
shell meta character, it will be matched against all installed
|
||||||
packages using
|
packages using
|
||||||
.Xr fnmatch 3 .
|
.Xr fnmatch 3 .
|
||||||
.Xr csh 1
|
.Xr csh 1
|
||||||
|
@ -109,10 +109,11 @@ will match versions 1.3 and later of the
|
||||||
.Pa name
|
.Pa name
|
||||||
package.
|
package.
|
||||||
The collating sequence of the various package version numbers is
|
The collating sequence of the various package version numbers is
|
||||||
unusual, but strives to be consistent. The magic string ``rc''
|
unusual, but strives to be consistent.
|
||||||
equates to
|
The magic string ``rc'' equates to
|
||||||
.Pa release candidate
|
.Pa release candidate
|
||||||
and sorts before a release. For example,
|
and sorts before a release.
|
||||||
|
For example,
|
||||||
.Pa name-1.3rc3
|
.Pa name-1.3rc3
|
||||||
will sort before
|
will sort before
|
||||||
.Pa name-1.3
|
.Pa name-1.3
|
||||||
|
@ -128,8 +129,9 @@ The magic string ``pl'' equates to a
|
||||||
and has the same value as a dot in the dewey-decimal ordering schemes.
|
and has the same value as a dot in the dewey-decimal ordering schemes.
|
||||||
.It Fl F
|
.It Fl F
|
||||||
Interpret any pkg-name given as filename, and translate it to a
|
Interpret any pkg-name given as filename, and translate it to a
|
||||||
package name using the Package Database. This can be used to query
|
package name using the Package Database.
|
||||||
information on a per-file basis, e.g. in conjunction with the
|
This can be used to query information on a per-file basis, e.g. in
|
||||||
|
conjunction with the
|
||||||
.Fl e
|
.Fl e
|
||||||
flag to find out which package a file belongs to.
|
flag to find out which package a file belongs to.
|
||||||
.It Fl f
|
.It Fl f
|
||||||
|
@ -141,9 +143,9 @@ Show the install script (if any) for each package.
|
||||||
.It Fl k
|
.It Fl k
|
||||||
Show the de-install script (if any) for each package.
|
Show the de-install script (if any) for each package.
|
||||||
.It Fl L
|
.It Fl L
|
||||||
Show the files within each package. This is different from just
|
Show the files within each package.
|
||||||
viewing the packing list, since full pathnames for everything
|
This is different from just viewing the packing list, since full pathnames
|
||||||
are generated.
|
for everything are generated.
|
||||||
.It Fl l Ar str
|
.It Fl l Ar str
|
||||||
Prefix each information category header (see
|
Prefix each information category header (see
|
||||||
.Fl q )
|
.Fl q )
|
||||||
|
@ -152,8 +154,8 @@ shown with
|
||||||
This is primarily of use to front-end programs that want to request a
|
This is primarily of use to front-end programs that want to request a
|
||||||
lot of different information fields at once for a package, but don't
|
lot of different information fields at once for a package, but don't
|
||||||
necessary want the output intermingled in such a way that they can't
|
necessary want the output intermingled in such a way that they can't
|
||||||
organize it. This lets you add a special token to the start of
|
organize it.
|
||||||
each field.
|
This lets you add a special token to the start of each field.
|
||||||
.It Fl m
|
.It Fl m
|
||||||
Show the mtree file (if any) for each package.
|
Show the mtree file (if any) for each package.
|
||||||
.It Fl n
|
.It Fl n
|
||||||
|
@ -171,8 +173,8 @@ Show the requirements script (if any) for each package.
|
||||||
Show the size of this package and all the packages it requires,
|
Show the size of this package and all the packages it requires,
|
||||||
in bytes.
|
in bytes.
|
||||||
.It Fl s
|
.It Fl s
|
||||||
Show the size of this package in bytes. The size is calculated by
|
Show the size of this package in bytes.
|
||||||
adding up the size of each file of the package.
|
The size is calculated by adding up the size of each file of the package.
|
||||||
.It Fl V
|
.It Fl V
|
||||||
Print version number and exit.
|
Print version number and exit.
|
||||||
.It Fl v
|
.It Fl v
|
||||||
|
@ -188,7 +190,8 @@ can be overridden by specifying an alternative directory in the
|
||||||
environment variable.
|
environment variable.
|
||||||
.It Ev PKG_PATH
|
.It Ev PKG_PATH
|
||||||
This can be used to specify a semicolon-separated list of paths and URLs to search for
|
This can be used to specify a semicolon-separated list of paths and URLs to search for
|
||||||
package files. If
|
package files.
|
||||||
|
If
|
||||||
.Ev PKG_PATH
|
.Ev PKG_PATH
|
||||||
is used, the suffix
|
is used, the suffix
|
||||||
.Pa .tgz
|
.Pa .tgz
|
||||||
|
@ -201,7 +204,8 @@ literally.
|
||||||
These are tried in turn (if set) as candidate directories in which
|
These are tried in turn (if set) as candidate directories in which
|
||||||
to create a ``staging area'' for any files extracted by
|
to create a ``staging area'' for any files extracted by
|
||||||
.Nm
|
.Nm
|
||||||
from package files. If neither
|
from package files.
|
||||||
|
If neither
|
||||||
.Ev PKG_TMPDIR
|
.Ev PKG_TMPDIR
|
||||||
nor
|
nor
|
||||||
.Ev TMPDIR
|
.Ev TMPDIR
|
||||||
|
@ -210,7 +214,8 @@ yields a suitable scratch directory,
|
||||||
.Pa /tmp ,
|
.Pa /tmp ,
|
||||||
and
|
and
|
||||||
.Pa /usr/tmp
|
.Pa /usr/tmp
|
||||||
are tried in turn. Note that
|
are tried in turn.
|
||||||
|
Note that
|
||||||
.Pa /usr/tmp
|
.Pa /usr/tmp
|
||||||
may be created, if it doesn't already exist.
|
may be created, if it doesn't already exist.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -228,12 +233,12 @@ in
|
||||||
.Pa /var/db/pkg/\*[Lt]pkg-name\*[Gt] .
|
.Pa /var/db/pkg/\*[Lt]pkg-name\*[Gt] .
|
||||||
.Pp
|
.Pp
|
||||||
A filename can be given instead of a (installed) package name to query
|
A filename can be given instead of a (installed) package name to query
|
||||||
information on the package this file belongs to. This filename is then
|
information on the package this file belongs to.
|
||||||
resolved to a package name using the Package Database. For this
|
This filename is then resolved to a package name using the Package Database.
|
||||||
translation to take place, the
|
For this translation to take place, the
|
||||||
.Fl F
|
.Fl F
|
||||||
flag must be given. The filename must be absolute, compare the output
|
flag must be given.
|
||||||
of pkg_info
|
The filename must be absolute, compare the output of pkg_info
|
||||||
.Fl aF .
|
.Fl aF .
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr pkg_add 1 ,
|
.Xr pkg_add 1 ,
|
||||||
|
|
Loading…
Reference in New Issue