summaryrefslogtreecommitdiff
path: root/pkgtools/pkg_tarup/files/pkg_tarup.1
diff options
context:
space:
mode:
Diffstat (limited to 'pkgtools/pkg_tarup/files/pkg_tarup.1')
-rw-r--r--pkgtools/pkg_tarup/files/pkg_tarup.1109
1 files changed, 109 insertions, 0 deletions
diff --git a/pkgtools/pkg_tarup/files/pkg_tarup.1 b/pkgtools/pkg_tarup/files/pkg_tarup.1
new file mode 100644
index 00000000000..cab9c72a30b
--- /dev/null
+++ b/pkgtools/pkg_tarup/files/pkg_tarup.1
@@ -0,0 +1,109 @@
+.\" $NetBSD: pkg_tarup.1,v 1.1 2004/07/14 16:08:48 erh Exp $
+.Dd July 14, 2004
+.Dt PKG_TARUP 1
+.Os
+.Sh NAME
+.Nm pkg_tarup
+.Nd a utility for tarring up installed software packages
+.Sh SYNOPSIS
+.Nm
+.Op Fl a
+.Bk -words
+.Op Fl K Ar pkg_dbdir
+.Ek
+.Bk -words
+.Op Fl d Ar pkgrepository
+.Ek
+.Bk -words
+.Op Fl s Ar pkg_sufx
+.Ek
+.Ar pkg-name-or-pattern
+.Op Ar ...
+.Sh DESCRIPTION
+The
+.Nm
+command is used to create a packed up file from an installed package.
+It can be used to tar up one or more packages, including dependant packges,
+if desired.
+.Pp
+The following options are available:
+.Bl -tag -width indent
+.It Fl a
+Create packages for all dependant packages too.
+.It Fl K Ar pkg_dbdir
+Set
+.Ar pkg_dbdir
+as the package database directory.
+If this option isn't specified, then the package database directory is
+taken from the value of the environment variable
+.Ev PKG_DBDIR
+if it's set, otherwise it defaults to
+.Pa @PKG_DBDIR@ .
+.It Fl d Ar pkgrepository
+Set
+.Ar pkgrepository
+as the destination directory for the created package file(s).
+If this option isn't specified, then /tmp is used.
+.It Fl s Ar pkg_sufx
+Set
+.Ar pkg_sufx
+as the extension used for the created package file(s).
+If this option isn't specified, then .tgz is used.
+.El
+.Sh EXIT STATUS
+The
+.Nm
+utility exits 0 on success.
+.Sh ENVIRONMENT
+The following environment variables affect the execution of
+.Nm :
+.Bl -tag -width indent
+.It Ev PREFIX
+Package binaries installation prefix used to build the path.
+Defaults to
+.Pa @PREFIX@ .
+.It Ev ECHO, ID, SED, SU, GREP
+Actual commands to use. These default to
+.Pa @ECHO@ ,
+.Pa @ID@ ,
+.Pa @SED@ ,
+.Pa @SU@
+and
+.Pa @GREP@ .
+.It Ev PKG_DBDIR
+If the
+.Fl K
+flag isn't given, then
+.Ev PKG_DBDIR
+is the location of the package database directory.
+The default package database directory is
+.Pa @PKG_DBDIR@ .
+.It Ev PKG_SUFX
+If the
+.Fl s
+flag isn't given, then
+.Ev PKG_SUFX
+is the suffix of the created package file.
+The default is
+.Pa @PKG_SUFX@ .
+.It Ev PKGREPOSITORY
+If the
+.Fl d
+flag isn't given, then
+.Ev PKGREPOSITORY
+is the destination directory for the created package file(s).
+The default is
+.Pa /tmp .
+.El
+.Pp
+Any variable that affects
+.Xr pkg_info 1
+or
+.Xr pkg_create 1 .
+.Sh SEE ALSO
+.Xr pkg_info 1 ,
+.Xr pkg_create 1 ,
+.Xr packages 7
+.Sh BUGS
+Packages that contain files with spaces in their names probably won't work.
+There is no way to safely tell pkg_create about these files.