From owner-freebsd-doc Thu Jun 25 07:30:44 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id HAA16063 for freebsd-doc-outgoing; Thu, 25 Jun 1998 07:30:44 -0700 (PDT) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id HAA15961 for ; Thu, 25 Jun 1998 07:30:23 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.8.8/8.8.5) id HAA25991; Thu, 25 Jun 1998 07:30:01 -0700 (PDT) Received: from tim.xenologics.com (tim.xenologics.com [194.77.5.24]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id HAA14864 for ; Thu, 25 Jun 1998 07:23:34 -0700 (PDT) (envelope-from seggers@semyam.dinoco.de) Received: (from uucp@localhost) by tim.xenologics.com (8.8.5/8.8.8) with UUCP id QAA18470 for FreeBSD-gnats-submit@freebsd.org; Thu, 25 Jun 1998 16:19:53 +0200 (MET DST) Received: (from seggers@localhost) by semyam.dinoco.de (8.8.8/8.8.8) id OAA23503; Thu, 25 Jun 1998 14:23:27 +0200 (CEST) (envelope-from seggers) Message-Id: <199806251223.OAA23503@semyam.dinoco.de> Date: Thu, 25 Jun 1998 14:23:27 +0200 (CEST) From: Stefan Eggers Reply-To: seggers@semyam.dinoco.de To: FreeBSD-gnats-submit@FreeBSD.ORG Cc: seggers@semyam.dinoco.de X-Send-Pr-Version: 3.2 Subject: docs/7064: pkg_* man pages are incomplete regarding env variables Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >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/ . +.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