mirror of
https://github.com/freebsd/freebsd-src
synced 2024-09-23 18:25:19 +00:00
Document environment variables used by pkg_{add,create,info}. These
include PKG_TMPDIR, TMPDIR, PKG_DBDIR. Add a FILES section to these manual pages. PR: docs/7064
This commit is contained in:
parent
85349cc396
commit
f618e998de
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=37166
|
@ -198,7 +198,7 @@ ftp.
|
||||||
.Sh TECHNICAL DETAILS
|
.Sh TECHNICAL DETAILS
|
||||||
.Nm Pkg_add
|
.Nm Pkg_add
|
||||||
is fairly simple. It extracts each package's "packing list"
|
is fairly simple. It extracts each package's "packing list"
|
||||||
into a special staging directory in /tmp (or $PKG_TMPDIR if set), parses it,
|
into a special staging directory, parses it,
|
||||||
and then runs through the following sequence to fully extract the contents:
|
and then runs through the following sequence to fully extract the contents:
|
||||||
.Bl -enum -indent indent
|
.Bl -enum -indent indent
|
||||||
.It
|
.It
|
||||||
|
@ -334,6 +334,48 @@ should be a series of entries seperated by colons. Each entry
|
||||||
consists of a directory name. The current directory may be indicated
|
consists of a directory name. The current directory may be indicated
|
||||||
implicitly by an empty directory name, or explicitly by a single
|
implicitly by an empty directory name, or explicitly by a single
|
||||||
period.
|
period.
|
||||||
|
.Pp
|
||||||
|
The environment variable
|
||||||
|
.Ev PKG_DBDIR
|
||||||
|
specifies an alternative location for the installed package database.
|
||||||
|
.Pp
|
||||||
|
The environment variables
|
||||||
|
.Ev PKG_TMPDIR
|
||||||
|
and
|
||||||
|
.Ev TMPDIR ,
|
||||||
|
in that order, are taken to name temporary directories where
|
||||||
|
.Nm
|
||||||
|
will attempt to create its staging area in.
|
||||||
|
If these variables are not present or if the directories named lack
|
||||||
|
sufficient space, then
|
||||||
|
.Nm
|
||||||
|
will use the first of
|
||||||
|
.Pa /var/tmp ,
|
||||||
|
.Pa /tmp
|
||||||
|
or
|
||||||
|
.Pa /usr/tmp
|
||||||
|
with sufficient space.
|
||||||
|
.Sh FILES
|
||||||
|
.Bl -tag -width /var/db/pkg -compact
|
||||||
|
.It Pa /var/tmp
|
||||||
|
Temporary directory for creating the staging area, if environmental variables
|
||||||
|
.Ev PKG_TMPDIR
|
||||||
|
or
|
||||||
|
.Ev TMPDIR
|
||||||
|
do not point to a suitable directory.
|
||||||
|
.It Pa /tmp
|
||||||
|
Next choice if
|
||||||
|
.Pa /var/tmp
|
||||||
|
does not exist or has insufficient space.
|
||||||
|
.It Pa /usr/tmp
|
||||||
|
Last choice if
|
||||||
|
.Pa /var/tmp
|
||||||
|
and
|
||||||
|
.Pa /tmp
|
||||||
|
are not suitable for creating the staging area.
|
||||||
|
.It Pa /var/db/pkg
|
||||||
|
Default location of the installed package database.
|
||||||
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr pkg_create 1 ,
|
.Xr pkg_create 1 ,
|
||||||
.Xr pkg_delete 1 ,
|
.Xr pkg_delete 1 ,
|
||||||
|
|
|
@ -15,7 +15,7 @@
|
||||||
.\"
|
.\"
|
||||||
.\"
|
.\"
|
||||||
.\" @(#)pkg_create.1
|
.\" @(#)pkg_create.1
|
||||||
.\" $Id: pkg_create.1,v 1.24 1998/03/23 08:27:14 charnier Exp $
|
.\" $Id: pkg_create.1,v 1.25 1998/05/24 03:11:17 steve Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" hacked up by John Kohl for NetBSD--fixed a few bugs, extended keywords,
|
.\" hacked up by John Kohl for NetBSD--fixed a few bugs, extended keywords,
|
||||||
.\" added dependency tracking, etc.
|
.\" added dependency tracking, etc.
|
||||||
|
@ -359,6 +359,40 @@ 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.
|
||||||
.El
|
.El
|
||||||
|
.Sh ENVIRONMENT
|
||||||
|
The environment variable
|
||||||
|
.Ev PKG_TMPDIR
|
||||||
|
names the directory where
|
||||||
|
.Nm
|
||||||
|
will attempt to create its temporary files.
|
||||||
|
If
|
||||||
|
.Ev PKG_TMPDIR
|
||||||
|
is not set,
|
||||||
|
the directory named by the contents of
|
||||||
|
.Ev TMPDIR
|
||||||
|
will be used.
|
||||||
|
If neither of
|
||||||
|
.Ev PKG_TMPDIR
|
||||||
|
and
|
||||||
|
.Ev TMPDIR
|
||||||
|
are set, the builtin defaults are used.
|
||||||
|
.Sh FILES
|
||||||
|
.Bl -tag -width /usr/tmp -compact
|
||||||
|
.It Pa /var/tmp
|
||||||
|
Temporary directory if environmental variables
|
||||||
|
.Ev PKG_TMPDIR
|
||||||
|
and
|
||||||
|
.Ev TMPDIR
|
||||||
|
are not set.
|
||||||
|
.It Pa /tmp
|
||||||
|
The next choice if
|
||||||
|
.Pa /var/tmp
|
||||||
|
does not exist.
|
||||||
|
.It Pa /usr/tmp
|
||||||
|
The last choice if
|
||||||
|
.Pa /tmp
|
||||||
|
is unsuitable.
|
||||||
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr pkg_add 1 ,
|
.Xr pkg_add 1 ,
|
||||||
.Xr pkg_delete 1 ,
|
.Xr pkg_delete 1 ,
|
||||||
|
|
|
@ -118,6 +118,36 @@ Package info is either extracted from package files named on the
|
||||||
command line, or from already installed package information
|
command line, or from already installed package information
|
||||||
in
|
in
|
||||||
.Pa /var/db/pkg/<pkg-name> .
|
.Pa /var/db/pkg/<pkg-name> .
|
||||||
|
.Sh ENVIRONMENT
|
||||||
|
.Ev PKG_TMPDIR
|
||||||
|
points to the directory where
|
||||||
|
.Nm
|
||||||
|
creates its temporary files.
|
||||||
|
If this variable is not set,
|
||||||
|
.Ev TMPDIR
|
||||||
|
is used. If both are unset, the builtin defaults are used.
|
||||||
|
.Pp
|
||||||
|
.Ev PKG_DBDIR
|
||||||
|
names the location of the installed package database.
|
||||||
|
.Sh FILES
|
||||||
|
.Bl -tag -width /var/db/pkg -compact
|
||||||
|
.It Pa /var/tmp
|
||||||
|
Used if the environment variables
|
||||||
|
.Ev PKG_TMPDIR
|
||||||
|
and
|
||||||
|
.Ev TMPDIR
|
||||||
|
are not set, or if the directories named have insufficient space.
|
||||||
|
.It Pa /tmp
|
||||||
|
The next choice if
|
||||||
|
.Pa /var/tmp
|
||||||
|
does not exist or has insufficient space.
|
||||||
|
.It Pa /usr/tmp
|
||||||
|
The last choice if
|
||||||
|
.Pa /tmp
|
||||||
|
is unsuitable.
|
||||||
|
.It Pa /var/db/pkg
|
||||||
|
Default location of the installed package database.
|
||||||
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr pkg_add 1 ,
|
.Xr pkg_add 1 ,
|
||||||
.Xr pkg_create 1 ,
|
.Xr pkg_create 1 ,
|
||||||
|
|
Loading…
Reference in a new issue