Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 25 Jun 1998 14:23:27 +0200 (CEST)
From:      Stefan Eggers <seggers@semyam.dinoco.de>
To:        FreeBSD-gnats-submit@FreeBSD.ORG
Cc:        seggers@semyam.dinoco.de
Subject:   docs/7064: pkg_* man pages are incomplete regarding env variables
Message-ID:  <199806251223.OAA23503@semyam.dinoco.de>

next in thread | raw e-mail | index | archive | help

>Number:         7064
>Category:       docs
>Synopsis:       pkg_* man pages are incomplete regarding env variables
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jun 25 07:30:01 PDT 1998
>Last-Modified:
>Originator:     Stefan Eggers
>Organization:
none
>Release:        FreeBSD 2.2.6-STABLE i386
>Environment:

	2.2-stable CVSUped around June, 20th 1998

>Description:

	The environment variables and directories used for temporary
files are insufficiently documented.

>How-To-Repeat:

	As mentioned often before with this type of bugs:  Just read
the man page.  :-)

>Fix:
	
	I made three diffs to the man pages.  They are:

--- add/pkg_add.1.ORIG	Sat Oct 18 07:55:12 1997
+++ add/pkg_add.1	Thu Jun 25 14:04:59 1998
@@ -198,7 +198,11 @@
 .Sh TECHNICAL DETAILS
 .Nm Pkg_add
 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 determined by the environment variables
+.Ev PKG_TMPDIR
+and
+.Ev TMPDIR ,
+parses it,
 and then runs through the following sequence to fully extract the contents:
 .Bl -enum -indent indent
 .It
@@ -334,6 +338,28 @@
 consists of a directory name. The current directory may be indicated
 implicitly by an empty directory name, or explicitly by a single
 period.
+.Pp
+.Ev PKG_TMPDIR
+points to the directory where pkg_add creates temporary files.
+.Ev TMPDIR
+gets used if
+.Ev PKG_TMPDIR
+is not set.  If both are unset built in defaults are used.
+.Sh FILES
+.Bl -tag -width /usr/tmp -compact
+.It Pa /var/tmp
+Used if
+.Ev PKG_TMPDIR
+and
+.Ev TMPDIR
+are either not set or the directories have insufficient space left.
+.It Pa /tmp
+The next choice if /var/tmp either does not exist or has insufficent
+space left.
+.It Pa /usr/tmp
+The last choice. Used if /tmp either does not exist or has
+insufficent space left.
+.El
 .Sh SEE ALSO
 .Xr pkg_create 1 ,
 .Xr pkg_delete 1 ,
----------------------------------------------------------------------
--- create/pkg_create.1.ORIG	Sun May 24 17:18:45 1998
+++ create/pkg_create.1	Thu Jun 25 14:00:00 1998
@@ -359,6 +359,28 @@
 .Cm @pkgdep
 directives may be used if the package depends on multiple other packages.
 .El
+.Sh ENVIRONMENT
+.Ev PKG_TMPDIR
+points to the directory where pkg_create creates temporary files.
+.Ev TMPDIR
+gets used if
+.Ev PKG_TMPDIR
+is not set.  If both are unset built in defaults are used.
+.Sh FILES
+.Bl -tag -width /usr/tmp -compact
+.It Pa /var/tmp
+Used if
+.Ev PKG_TMPDIR
+and
+.Ev TMPDIR
+are either not set or the directories have insufficient space left.
+.It Pa /tmp
+The next choice if /var/tmp either does not exist or has insufficent
+space left.
+.It Pa /usr/tmp
+The last choice. Used if /tmp either does not exist or has
+insufficent space left.
+.El
 .Sh SEE ALSO
 .Xr pkg_add 1 ,
 .Xr pkg_delete 1 ,
----------------------------------------------------------------------
--- info/pkg_info.1.ORIG	Thu Oct  9 09:09:45 1997
+++ info/pkg_info.1	Thu Jun 25 14:00:12 1998
@@ -118,6 +118,28 @@
 command line, or from already installed package information
 in
 .Pa /var/db/pkg/<pkg-name> .
+.Sh ENVIRONMENT
+.Ev PKG_TMPDIR
+points to the directory where pkg_info creates temporary files.
+.Ev TMPDIR
+gets used if
+.Ev PKG_TMPDIR is not set.  If both are unset built in defaults are
+used.
+.Sh FILES
+.Bl -tag -width /usr/tmp -compact
+.It Pa /var/tmp
+Used if
+.Ev PKG_TMPDIR
+and
+.Ev TMPDIR
+are either not set or the directories have insufficient space left.
+.It Pa /tmp
+The next choice if /var/tmp either does not exist or has insufficent
+space left.
+.It Pa /usr/tmp
+The last choice. Used if /tmp either does not exist or has
+insufficent space left.
+.El
 .Sh SEE ALSO
 .Xr pkg_add 1 ,
 .Xr pkg_create 1 ,
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199806251223.OAA23503>