Ispell. Begin new sentences on a new line.

This commit is contained in:
wiz 2002-09-26 01:41:51 +00:00
parent e3ff4e979b
commit 5e977f5ead
5 changed files with 218 additions and 165 deletions

View File

@ -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 .

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 ,