summaryrefslogtreecommitdiffstats
path: root/usr.sbin/pkg_install/add
diff options
context:
space:
mode:
authorkensmith <kensmith@FreeBSD.org>2004-03-01 21:50:49 +0000
committerkensmith <kensmith@FreeBSD.org>2004-03-01 21:50:49 +0000
commitd48c225260752c53c2b2fbf9ce45062ea73bb7ce (patch)
tree22e5f99f47dae97922c4bc1fe4f27ae797a4fcaa /usr.sbin/pkg_install/add
parent08eaf5dabb95cdfa6569427975c2ac2da4e25e68 (diff)
downloadFreeBSD-src-d48c225260752c53c2b2fbf9ce45062ea73bb7ce.zip
FreeBSD-src-d48c225260752c53c2b2fbf9ce45062ea73bb7ce.tar.gz
This is an initial whitespace cleanup commit, new content to follow.
Adding hard line breaks at the end of sentences. Approved by: rwatson (mentor)
Diffstat (limited to 'usr.sbin/pkg_install/add')
-rw-r--r--usr.sbin/pkg_install/add/pkg_add.157
1 files changed, 38 insertions, 19 deletions
diff --git a/usr.sbin/pkg_install/add/pkg_add.1 b/usr.sbin/pkg_install/add/pkg_add.1
index 6182842..7940482 100644
--- a/usr.sbin/pkg_install/add/pkg_add.1
+++ b/usr.sbin/pkg_install/add/pkg_add.1
@@ -47,10 +47,12 @@ or other subtle
attacks from miscreants who create dangerous package files.
.Pp
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.
+For extra protection, use the
.Fl M
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
+ensure it poses no danger to your system's integrity.
+Pay particular
attention to any +INSTALL, +POST-INSTALL, +DEINSTALL, +POST-DEINSTALL,
+REQUIRE or +MTREE_DIRS files, and inspect the +CONTENTS file for
.Cm @cwd ,
@@ -68,7 +70,8 @@ command to examine the package file.
The following command line arguments are supported:
.Bl -tag -width indent
.It Ar pkg-name Op Ar pkg-name ...
-The named packages are installed. A package name of - will cause
+The named packages are installed.
+A package name of - will cause
.Nm
to read from stdin.
If the packages are not found in the current
@@ -85,7 +88,8 @@ package, do not execute them.
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
+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 r
@@ -94,7 +98,8 @@ This will determine the appropriate
objformat and release and then fetch and install the package.
.It Fl f
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
will still try to find and auto-install missing prerequisite packages,
a failure to find one will not be fatal.
@@ -103,12 +108,14 @@ Set
.Ar prefix
as the directory in which to extract files from a package.
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
directive will be replaced, since
.Nm
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.
+It is rare in any case to see more than one
directory transition made, but when such does happen and you wish
to have control over *all* directory transitions, then you
may then wish to look into the use of
@@ -132,7 +139,8 @@ By default, this is the string
but it may be necessary to override it in the situation where
space in your
.Pa /var/tmp
-directory is limited. Be sure to leave some number of `X' characters
+directory is limited.
+Be sure to leave some number of `X' characters
for
.Xr mktemp 3
to fill in with a unique ID.
@@ -145,11 +153,13 @@ file installation; often this is
.It Fl M
Run in
.Cm MASTER
-mode. This is a very specialized mode for running
+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,
+mode.
+When run in this mode,
.Nm
does no work beyond extracting the package into a temporary staging
area (see the
@@ -165,15 +175,18 @@ before acting on its contents.
.It Fl S
Run in
.Cm SLAVE
-mode. This is a very specialized mode for running
+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,
+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,
+from stdin.
+The complete packing list is also read from stdin,
and the contents then acted on as normal.
.El
.Pp
@@ -183,7 +196,8 @@ arguments may be specified, each being either a file containing the
package (these usually end with a
.Dq .tbz
suffix) or a
-URL pointing at a file available on an ftp site. Thus you may
+URL pointing at a file available on an ftp site.
+Thus you may
extract files directly from their anonymous ftp locations (e.g.\&
.Nm
.Li ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/shells/bash-1.14.7.tbz ) .
@@ -196,8 +210,10 @@ the variable
.Bf -emphasis
FTP_PASSIVE_MODE
.Ef
-to some value in your environment. Otherwise, the more standard
-ACTIVE mode may be used. If
+to some value in your environment.
+Otherwise, the more standard
+ACTIVE mode may be used.
+If
.Nm
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
@@ -379,7 +395,8 @@ All the scripts are called with the environment variable
.Ev PKG_PREFIX
set to the installation prefix (see the
.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
is installed, even if the user might change it with the
.Fl p
@@ -388,8 +405,10 @@ flag to
.Sh ENVIRONMENT
The value of the
.Ev PKG_PATH
-is used if a given package can't be found. The environment variable
-should be a series of entries separated by colons. Each entry
+is used if a given package can't be found.
+The environment variable
+should be a series of entries separated by colons.
+Each entry
consists of a directory name.
The current directory may be indicated
implicitly by an empty directory name, or explicitly by a single
OpenPOWER on IntegriCloud