| pkg_add.1 (176108) | pkg_add.1 (179433) |
|---|---|
| 1.\" 2.\" FreeBSD install - a package for the installation and maintainance 3.\" of non-core utilities. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 14.\" Jordan K. Hubbard 15.\" | 1.\" 2.\" FreeBSD install - a package for the installation and maintainance 3.\" of non-core utilities. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 14.\" Jordan K. Hubbard 15.\" |
| 16.\" $FreeBSD: head/usr.sbin/pkg_install/add/pkg_add.1 176108 2008-02-08 14:00:01Z ru $ | 16.\" $FreeBSD: head/usr.sbin/pkg_install/add/pkg_add.1 179433 2008-05-30 14:26:09Z flz $ |
| 17.\" | 17.\" |
| 18.Dd November 29, 2007 | 18.Dd May 30, 2008 |
| 19.Dt PKG_ADD 1 20.Os 21.Sh NAME 22.Nm pkg_add 23.Nd a utility for installing software package distributions 24.Sh SYNOPSIS 25.Nm 26.Op Fl viInfFrRMSK --- 49 unchanged lines hidden (view full) --- 76will cause 77.Nm 78to read from stdin. 79If the packages are not found in the current 80working directory, 81.Nm 82will search them in each directory named by 83.Ev PKG_PATH . | 19.Dt PKG_ADD 1 20.Os 21.Sh NAME 22.Nm pkg_add 23.Nd a utility for installing software package distributions 24.Sh SYNOPSIS 25.Nm 26.Op Fl viInfFrRMSK --- 49 unchanged lines hidden (view full) --- 76will cause 77.Nm 78to read from stdin. 79If the packages are not found in the current 80working directory, 81.Nm 82will search them in each directory named by 83.Ev PKG_PATH . |
| 84.It Fl v | 84.It Fl v , -verbose |
| 85Turn on verbose output. | 85Turn on verbose output. |
| 86.It Fl K | 86.It Fl K , -keep |
| 87Keep any downloaded package in 88.Ev PKGDIR 89if it is defined or in current directory by default. | 87Keep any downloaded package in 88.Ev PKGDIR 89if it is defined or in current directory by default. |
| 90.It Fl i | 90.It Fl i , -no-deps |
| 91Install the package without fetching and installing 92dependencies. | 91Install the package without fetching and installing 92dependencies. |
| 93.It Fl I | 93.It Fl I , -no-scripts |
| 94If any installation scripts (pre-install or post-install) exist for a given 95package, do not execute them. | 94If any installation scripts (pre-install or post-install) exist for a given 95package, do not execute them. |
| 96.It Fl n | 96.It Fl n , -dry-run |
| 97Do not actually install a package, just report the steps that 98would be taken if it was. | 97Do not actually install a package, just report the steps that 98would be taken if it was. |
| 99.It Fl R | 99.It Fl R , -no-record |
| 100Do not record the installation of a package. 101This means 102that you cannot deinstall it later, so only use this option if 103you know what you are doing! | 100Do not record the installation of a package. 101This means 102that you cannot deinstall it later, so only use this option if 103you know what you are doing! |
| 104.It Fl r | 104.It Fl r , -remote |
| 105Use the remote fetching feature. 106This will determine the appropriate 107objformat and release and then fetch and install the package. | 105Use the remote fetching feature. 106This will determine the appropriate 107objformat and release and then fetch and install the package. |
| 108.It Fl f | 108.It Fl f , -force |
| 109Force installation to proceed even if prerequisite packages are not 110installed or the requirements script fails. 111Although 112.Nm 113will still try to find and auto-install missing prerequisite packages, 114a failure to find one will not be fatal. 115.It Fl F 116Already installed packages are not an error. | 109Force installation to proceed even if prerequisite packages are not 110installed or the requirements script fails. 111Although 112.Nm 113will still try to find and auto-install missing prerequisite packages, 114a failure to find one will not be fatal. 115.It Fl F 116Already installed packages are not an error. |
| 117.It Fl p Ar prefix | 117.It Fl p , -prefix Ar prefix |
| 118Set 119.Ar prefix 120as the directory in which to extract files from a package. 121If a package has set its default directory, it will be overridden 122by this flag. 123Note that only the first 124.Cm @cwd 125directive will be replaced, since --- 31 unchanged lines hidden (view full) --- 157.Fl P 158flag appears after any 159.Fl p 160flag on the command line, it overrides its effect, causing 161.Nm 162to use the given 163.Ar prefix 164recursively. | 118Set 119.Ar prefix 120as the directory in which to extract files from a package. 121If a package has set its default directory, it will be overridden 122by this flag. 123Note that only the first 124.Cm @cwd 125directive will be replaced, since --- 31 unchanged lines hidden (view full) --- 157.Fl P 158flag appears after any 159.Fl p 160flag on the command line, it overrides its effect, causing 161.Nm 162to use the given 163.Ar prefix 164recursively. |
| 165.It Fl t Ar template | 165.It Fl t , -template Ar template |
| 166Use 167.Ar template 168as the input to 169.Xr mktemp 3 170when creating a 171.Dq staging area . 172By default, this is the string 173.Pa /var/tmp/instmp.XXXXXX , --- 6 unchanged lines hidden (view full) --- 180.Xr mktemp 3 181to fill in with a unique ID. 182.Pp 183You can get a performance boost by setting the staging area 184.Ar template 185to reside on the same disk partition as target directories for package 186file installation; often this is 187.Pa /usr . | 166Use 167.Ar template 168as the input to 169.Xr mktemp 3 170when creating a 171.Dq staging area . 172By default, this is the string 173.Pa /var/tmp/instmp.XXXXXX , --- 6 unchanged lines hidden (view full) --- 180.Xr mktemp 3 181to fill in with a unique ID. 182.Pp 183You can get a performance boost by setting the staging area 184.Ar template 185to reside on the same disk partition as target directories for package 186file installation; often this is 187.Pa /usr . |
| 188.It Fl M | 188.It Fl M , -master |
| 189Run in 190.Cm MASTER 191mode. 192This is a very specialized mode for running 193.Nm 194and is meant to be run in conjunction with 195.Cm SLAVE 196mode. --- 5 unchanged lines hidden (view full) --- 202option), reading in the packing list, and then dumping it (prefaced by 203the current staging area) to stdout where it may be filtered by a 204program such as 205.Xr sed 1 . 206When used in conjunction with 207.Cm SLAVE 208mode, it allows you to make radical changes to the package structure 209before acting on its contents. | 189Run in 190.Cm MASTER 191mode. 192This is a very specialized mode for running 193.Nm 194and is meant to be run in conjunction with 195.Cm SLAVE 196mode. --- 5 unchanged lines hidden (view full) --- 202option), reading in the packing list, and then dumping it (prefaced by 203the current staging area) to stdout where it may be filtered by a 204program such as 205.Xr sed 1 . 206When used in conjunction with 207.Cm SLAVE 208mode, it allows you to make radical changes to the package structure 209before acting on its contents. |
| 210.It Fl S | 210.It Fl S , -slave |
| 211Run in 212.Cm SLAVE 213mode. 214This is a very specialized mode for running 215.Nm 216and is meant to be run in conjunction with 217.Cm MASTER 218mode. 219When run in this mode, 220.Nm 221expects the release contents to be already extracted and waiting 222in the staging area, the location of which is read as a string 223from stdin. 224The complete packing list is also read from stdin, 225and the contents then acted on as normal. | 211Run in 212.Cm SLAVE 213mode. 214This is a very specialized mode for running 215.Nm 216and is meant to be run in conjunction with 217.Cm MASTER 218mode. 219When run in this mode, 220.Nm 221expects the release contents to be already extracted and waiting 222in the staging area, the location of which is read as a string 223from stdin. 224The complete packing list is also read from stdin, 225and the contents then acted on as normal. |
| 226.It Fl C Ar chrootdir | 226.It Fl C , -chroot Ar chrootdir |
| 227Before doing any operations, 228.Xr chroot 2 229to the 230.Ar chrootdir 231directory so that all package files, and the package database, are 232installed to 233.Ar chrootdir . 234Note that --- 369 unchanged lines hidden --- | 227Before doing any operations, 228.Xr chroot 2 229to the 230.Ar chrootdir 231directory so that all package files, and the package database, are 232installed to 233.Ar chrootdir . 234Note that --- 369 unchanged lines hidden --- |