diff --git a/usr.sbin/pkg_install/add/pkg_add.1 b/usr.sbin/pkg_install/add/pkg_add.1 index cbfe3a35a35a..cc42d20c72d6 100644 --- a/usr.sbin/pkg_install/add/pkg_add.1 +++ b/usr.sbin/pkg_install/add/pkg_add.1 @@ -1,4 +1,4 @@ -.\" $NetBSD: pkg_add.1,v 1.20 2000/10/05 12:45:22 ad Exp $ +.\" $NetBSD: pkg_add.1,v 1.21 2001/01/07 01:39:20 hubertf Exp $ .\" .\" FreeBSD install - a package for the installation and maintainance .\" of non-core utilities. @@ -86,23 +86,37 @@ will search them in each directory named by the environment variable. Any dependencies required by the installed package will be searched in the same location that the original package was installed from. -.It Fl v -Turn on verbose output. -.It Fl I -If an installation script exists for a given package, do not execute it. -.It Fl n -Don't actually install a package, just report the steps that -would be taken if it was. -.It Fl R -Do not record the installation of a package. This means -that you cannot deinstall it later, so only use this option if -you know what you are doing! .It Fl f Force installation to proceed even if prerequisite packages are not installed or the requirements script fails. Although .Nm will still try to find and auto-install missing prerequisite packages, a failure to find one will not be fatal. +.It Fl I +If an installation script exists for a given package, do not execute it. +.It Fl M +Run in +.Cm MASTER +mode. This is a very specialized mode for running +.Nm +and is meant to be run in conjunction with +.Cm SLAVE +mode. When run in this mode, +.Nm +does no work beyond extracting the package into a temporary staging +area (see the +.Fl t +option), reading in the packing list, and then dumping it (prefaced by +the current staging area) to stdout where it may be filtered by a +program such as +.Xr sed 1 . +When used in conjunction with +.Cm SLAVE +mode, it allows you to make radical changes to the package structure +before acting on its contents. +.It Fl n +Don't actually install a package, just report the steps that +would be taken if it was. .It Fl p Ar prefix Set .Ar prefix @@ -125,6 +139,23 @@ modes (see the and .Fl S options). +.It Fl R +Do not record the installation of a package. This means +that you cannot deinstall it later, so only use this option if +you know what you are doing! +.It Fl S +Run in +.Cm SLAVE +mode. This is a very specialized mode for running +.Nm +and is meant to be run in conjunction with +.Cm MASTER +mode. When run in this mode, +.Nm +expects the release contents to be already extracted and waiting +in the staging area, the location of which is read as a string +from stdin. The complete packing list is also read from stdin, +and the contents then acted on as normal. .It Fl t Ar template Use .Ar template @@ -146,39 +177,8 @@ You can get a performance boost by setting the staging area to reside on the same disk partition as target directories for package file installation; often this is .Pa /usr . -.It Fl M -Run in -.Cm MASTER -mode. This is a very specialized mode for running -.Nm -and is meant to be run in conjunction with -.Cm SLAVE -mode. When run in this mode, -.Nm -does no work beyond extracting the package into a temporary staging -area (see the -.Fl t -option), reading in the packing list, and then dumping it (prefaced by -the current staging area) to stdout where it may be filtered by a -program such as -.Xr sed 1 . -When used in conjunction with -.Cm SLAVE -mode, it allows you to make radical changes to the package structure -before acting on its contents. -.It Fl S -Run in -.Cm SLAVE -mode. This is a very specialized mode for running -.Nm -and is meant to be run in conjunction with -.Cm MASTER -mode. When run in this mode, -.Nm -expects the release contents to be already extracted and waiting -in the staging area, the location of which is read as a string -from stdin. The complete packing list is also read from stdin, -and the contents then acted on as normal. +.It Fl v +Turn on verbose output. .El .Pp One or more diff --git a/usr.sbin/pkg_install/admin/pkg_admin.1 b/usr.sbin/pkg_install/admin/pkg_admin.1 index d8476c130db2..88fb5368cec8 100644 --- a/usr.sbin/pkg_install/admin/pkg_admin.1 +++ b/usr.sbin/pkg_install/admin/pkg_admin.1 @@ -1,4 +1,4 @@ -.\" $NetBSD: pkg_admin.1,v 1.10 2000/11/12 15:32:57 wiz Exp $ +.\" $NetBSD: pkg_admin.1,v 1.11 2001/01/07 01:39:20 hubertf Exp $ .\" .\" Copyright (c) 1999 Hubert Feyrer. All rights reserved. .\" @@ -43,25 +43,6 @@ This command performs various administrative tasks around the NetBSD Packages System. Available commands are: .Pp .Bl -tag -width check [pkg] -.It Cm rebuild -Rebuild the package database mapping from scratch, scanning -subdirectories in -.Pa /var/db/pkg -for -.Pa +CONTENTS -files, parsing them and writing the resulting absolute pathnames -together with the package they belong to into the package database. -.Pp -This option is intended to be used for upgrading from non-pkgdb-pkg_* -tools to pkgdb-pkg_* tools, further manipulation of the pkgdb will be -done by -.Xr pkg_add 1 , -.Xr pkg_delete 1 -and -.Xr pkg_create 1 . -.Pp -Needs to be run as root. -.Pp .It Cm check Ar [pkg ...] Use this command to check the files belonging to some or all of the packages installed on the local machine against their MD5 checksum @@ -110,6 +91,25 @@ yui# pkg_admin lsall /usr/pkgsrc/packages/i386ELF/All/'{mit,unproven}-pthread*' /usr/pkgsrc/packages/i386ELF/All/mit-pthreads-1.60b6.tgz /usr/pkgsrc/packages/i386ELF/All/unproven-pthreads-0.15.tgz .Ed +.It Cm rebuild +Rebuild the package database mapping from scratch, scanning +subdirectories in +.Pa /var/db/pkg +for +.Pa +CONTENTS +files, parsing them and writing the resulting absolute pathnames +together with the package they belong to into the package database. +.Pp +This option is intended to be used for upgrading from non-pkgdb-pkg_* +tools to pkgdb-pkg_* tools, further manipulation of the pkgdb will be +done by +.Xr pkg_add 1 , +.Xr pkg_delete 1 +and +.Xr pkg_create 1 . +.Pp +Needs to be run as root. +.Pp .El .Pp .Sh ENVIRONMENT diff --git a/usr.sbin/pkg_install/create/pkg_create.1 b/usr.sbin/pkg_install/create/pkg_create.1 index 131b50018600..349e70d80c92 100644 --- a/usr.sbin/pkg_install/create/pkg_create.1 +++ b/usr.sbin/pkg_install/create/pkg_create.1 @@ -1,4 +1,4 @@ -.\" $NetBSD: pkg_create.1,v 1.24 2000/07/05 15:45:36 msaitoh Exp $ +.\" $NetBSD: pkg_create.1,v 1.25 2001/01/07 01:39:20 hubertf Exp $ .\" .\" FreeBSD install - a package for the installation and maintainance .\" of non-core utilities. @@ -104,6 +104,15 @@ description of the input syntax is included in this document. .Sh OPTIONS The following command line options are supported: .Bl -tag -width indent +.It Fl b Ar build-version-file +Install the file +.Ar build-version-file +so that users of binary packages can see what versions of +the files used to control the build were used when creating the +binary package. This allows some fine-grained version control information +to be retained in a binary package and viewed wherever it is installed, +using +.Xr pkg_info 1 . .It Fl B Ar build-info-file Install the file .Ar build-info-file @@ -115,65 +124,6 @@ binary package. This allows various build definitions to be retained in a binary package and viewed wherever it is installed, using .Xr pkg_info 1 . -.It Fl C Ar cpkgs -Set the initial package conflict list to -.Ar cpkgs . -This is assumed to be a whitespace separated list of package names -and is meant as a convenient shorthand for specifying multiple -.Cm @pkgcfl -directives in the packing list (see PACKING LIST DETAILS section below). -.It Fl D Ar displayfile -Display the file after installing the package. Useful for things like -legal notices on almost-free software, etc. -.It Fl L Ar SrcDir -This sets the package's @src directive; see below for a description -of what this does. -.It Fl O -Go into a `packing list Only' mode. -This is used to do `fake pkg_add' operations when a package is installed. -In such cases, it is necessary to know what the final, adjusted packing -list will look like. -.It Fl P Ar dpkgs -Set the initial package dependency list to -.Ar dpkgs . -This is assumed to be a whitespace separated list of package names -and is meant as a convenient shorthand for specifying multiple -.Cm @pkgdep -directives in the packing list (see PACKING LIST DETAILS section below). -.It Fl R -Re-order any directories in the pkg/PLIST file into reverse alphabetic -order, so that child directories will automatically be removed before -parent directories. -.It Fl S Ar size-all-file -Store the given file for later querying with the -.Xr pkg_info 1 -.Ar -S -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 -ASCII string, terminated by a newline. -.It Fl X Ar excludefile -Pass -.Ar excludefile -as a -.Fl -exclude-from -argument to -.Cm tar -when creating final package. See -.Cm tar -man page (or run -.Cm tar -with -.Fl -help -flag) for further information on using this flag. -.It Fl b Ar build-version-file -Install the file -.Ar build-version-file -so that users of binary packages can see what versions of -the files used to control the build were used when creating the -binary package. This allows some fine-grained version control information -to be retained in a binary package and viewed wherever it is installed, -using -.Xr pkg_info 1 . .It Fl c Ar [-]desc Fetch package ``one line description'' from file .Ar desc @@ -182,12 +132,22 @@ or, if preceded by the argument itself. This string should also give some idea of which version of the product (if any) the package represents. +.It Fl C Ar cpkgs +Set the initial package conflict list to +.Ar cpkgs . +This is assumed to be a whitespace separated list of package names +and is meant as a convenient shorthand for specifying multiple +.Cm @pkgcfl +directives in the packing list (see PACKING LIST DETAILS section below). .It Fl d Ar [-]desc Fetch long description for package from file .Ar desc or, if preceded by .Cm - , the argument itself. +.It Fl D Ar displayfile +Display the file after installing the package. Useful for things like +legal notices on almost-free software, etc. .It Fl f Ar packinglist Fetch ``packing list'' for package from the file .Ar packinglist @@ -221,6 +181,9 @@ and .Xr symlink 2 to remove and re-link any symbolic links which are targetted at full path names. +.It Fl L Ar SrcDir +This sets the package's @src directive; see below for a description +of what this does. .It Fl m Ar mtreefile Run .Xr mtree 8 @@ -239,11 +202,23 @@ where is the name of the first directory named by a .Cm @cwd directive. +.It Fl O +Go into a `packing list Only' mode. +This is used to do `fake pkg_add' operations when a package is installed. +In such cases, it is necessary to know what the final, adjusted packing +list will look like. .It Fl p Ar prefix Set .Ar prefix as the initial directory ``base'' to start from in selecting files for the package. +.It Fl P Ar dpkgs +Set the initial package dependency list to +.Ar dpkgs . +This is assumed to be a whitespace separated list of package names +and is meant as a convenient shorthand for specifying multiple +.Cm @pkgdep +directives in the packing list (see PACKING LIST DETAILS section below). .It Fl r Ar rscript Set .Ar rscript @@ -251,12 +226,23 @@ to be the ``requirements'' procedure for the package. This can be any executable program (or shell script). It will be invoked automatically at installation/deinstallation time to determine whether or not installation/deinstallation should proceed. +.It Fl R +Re-order any directories in the pkg/PLIST file into reverse alphabetic +order, so that child directories will automatically be removed before +parent directories. .It Fl s Ar size-pkg-file Store the given file for later querying with the .Xr pkg_info 1 .Ar -s 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. +.It Fl S Ar size-all-file +Store the given file for later querying with the +.Xr pkg_info 1 +.Ar -S +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 +ASCII string, terminated by a newline. .It Fl t Ar template Use .Ar template @@ -273,6 +259,20 @@ for to fill in with a unique ID. .It Fl v Turn on verbose output. +.It Fl X Ar excludefile +Pass +.Ar excludefile +as a +.Fl -exclude-from +argument to +.Cm tar +when creating final package. See +.Cm tar +man page (or run +.Cm tar +with +.Fl -help +flag) for further information on using this flag. .El .Pp .Sh PACKING LIST DETAILS diff --git a/usr.sbin/pkg_install/delete/pkg_delete.1 b/usr.sbin/pkg_install/delete/pkg_delete.1 index 2623af6eb387..5b7897ca5054 100644 --- a/usr.sbin/pkg_install/delete/pkg_delete.1 +++ b/usr.sbin/pkg_install/delete/pkg_delete.1 @@ -1,4 +1,4 @@ -.\" $NetBSD: pkg_delete.1,v 1.17 2000/11/07 06:43:37 lukem Exp $ +.\" $NetBSD: pkg_delete.1,v 1.18 2001/01/07 01:39:21 hubertf Exp $ .\" .\" FreeBSD install - a package for the installation and maintainance .\" of non-core utilities. @@ -78,10 +78,25 @@ If the flag is given, one or more (absolute) filenames may be specified and the Package Database will be consulted for the package to which the given file belongs. These packages are then deinstalled. -.It Fl v -Turn on verbose output. +.It Fl d +Remove empty directories created by file cleanup. By default, only +files/directories explicitly listed in a package's contents (either as +normal files/directories or with the +.Cm @dirrm +directive) will be removed at deinstallation time. This option tells +.Nm +to also remove any directories that were emptied as a result of removing +the package. .It Fl D If a deinstallation script exists for a given package, do not execute it. +.It Fl f +Force removal of the package, even if a dependency is recorded or the +deinstall or require script fails. +.It Fl F +Any pkg-name given will be interpreted as pathname which is +subsequently transformed in a (real) package name via the Package +Database. That way, packges can be deleted by giving a filename +instead of the package-name. .It Fl n Don't actually deinstall a package, just report the steps that would be taken if it were. @@ -109,25 +124,9 @@ option, this does a recursive delete. The option deletes the given package and any packages required by it, unless some other package still needs them. This can be used to delete a package and all the packages it needs. -.It Fl d -Remove empty directories created by file cleanup. By default, only -files/directories explicitly listed in a package's contents (either as -normal files/directories or with the -.Cm @dirrm -directive) will be removed at deinstallation time. This option tells -.Nm -to also remove any directories that were emptied as a result of removing -the package. -.It Fl F -Any pkg-name given will be interpreted as pathname which is -subsequently transformed in a (real) package name via the Package -Database. That way, packges can be deleted by giving a filename -instead of the package-name. -.It Fl f -Force removal of the package, even if a dependency is recorded or the -deinstall or require script fails. +.It Fl v +Turn on verbose output. .El - .Pp .Sh TECHNICAL DETAILS .Nm