Radish alpha
H
rad:z3QDZAW2FAfuLvihrhiyDC9fAD8G9
HardenedBSD Package Manager
Radicle
Git
man pages should be in section 8, not 1
Baptiste Daroussin committed 14 years ago
commit 3556541a0662b196dc519ac9ca3ca737cf15808c
parent 5ca6236
35 files changed +1798 -1798
modified pkg/Makefile
@@ -44,23 +44,23 @@ LDADD+= -L${.OBJDIR}/../libpkg \
		${LDADD_STATIC}

WARNS?=		6
-
MAN=	pkg.1 \
-
	pkg-add.1 \
-
	pkg-autoremove.1 \
-
	pkg-backup.1 \
-
	pkg-create.1 \
-
	pkg-delete.1 \
-
	pkg-info.1 \
-
	pkg-install.1 \
-
	pkg-query.1 \
-
	pkg-register.1 \
-
	pkg-repo.1 \
-
	pkg-search.1 \
-
	pkg-update.1 \
-
	pkg-updating.1 \
-
	pkg-upgrade.1 \
-
	pkg-version.1 \
-
	pkg-which.1 \
+
MAN=	pkg.8 \
+
	pkg-add.8 \
+
	pkg-autoremove.8 \
+
	pkg-backup.8 \
+
	pkg-create.8 \
+
	pkg-delete.8 \
+
	pkg-info.8 \
+
	pkg-install.8 \
+
	pkg-query.8 \
+
	pkg-register.8 \
+
	pkg-repo.8 \
+
	pkg-search.8 \
+
	pkg-update.8 \
+
	pkg-updating.8 \
+
	pkg-upgrade.8 \
+
	pkg-version.8 \
+
	pkg-which.8 \
	pkg.conf.5

.include <bsd.prog.mk>
deleted pkg/pkg-add.1
@@ -1,72 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-ADD 1
-
.Os
-
.Sh NAME
-
.Nm "pkg add"
-
.Nd Registers a package and installs it on the system
-
.Sh SYNOPSIS
-
.Nm
-
.Ar <pkg-name>
-
.Nm
-
.Ar <url>://<pkg-name>
-
.Sh DESCRIPTION
-
.Nm
-
installs a package from either a local source or a remote one.
-
.Pp
-
When installing from a remote source you need to specify
-
the protocol to use when fetching the package.
-
.Pp
-
Currently supported protocols are FTP, HTTP and HTTPS.
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It Ev ASSUME_ALWAYS_YES
-
.It Ev HANDLE_RC_SCRIPTS
-
.It Ev PKG_DBDIR
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-add.8
@@ -0,0 +1,72 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 1. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.8
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-ADD 8
+
.Os
+
.Sh NAME
+
.Nm "pkg add"
+
.Nd Registers a package and installs it on the system
+
.Sh SYNOPSIS
+
.Nm
+
.Ar <pkg-name>
+
.Nm
+
.Ar <url>://<pkg-name>
+
.Sh DESCRIPTION
+
.Nm
+
installs a package from either a local source or a remote one.
+
.Pp
+
When installing from a remote source you need to specify
+
the protocol to use when fetching the package.
+
.Pp
+
Currently supported protocols are FTP, HTTP and HTTPS.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It Ev ASSUME_ALWAYS_YES
+
.It Ev HANDLE_RC_SCRIPTS
+
.It Ev PKG_DBDIR
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-autoremove.1
@@ -1,68 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-AUTOREMOVE 1
-
.Os
-
.Sh NAME
-
.Nm "pkg autoremove"
-
.Nd removes orphan packages
-
.Sh SYNOPSIS
-
.Nm
-
.Op Fl y
-
.Sh DESCRIPTION
-
.Nm
-
is used for removing orphan packages, which were installed
-
during a dependencies resolving and are no longer needed.
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.It Fl y
-
Assume yes when asked for confirmation before package autoremoval.
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It Ev ASSUME_ALWAYS_YES
-
.It Ev HANDLE_RC_SCRIPTS
-
.It Ev PKG_DBDIR
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-autoremove.8
@@ -0,0 +1,68 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 1. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.8
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-AUTOREMOVE 8
+
.Os
+
.Sh NAME
+
.Nm "pkg autoremove"
+
.Nd removes orphan packages
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl y
+
.Sh DESCRIPTION
+
.Nm
+
is used for removing orphan packages, which were installed
+
during a dependencies resolving and are no longer needed.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl y
+
Assume yes when asked for confirmation before package autoremoval.
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It Ev ASSUME_ALWAYS_YES
+
.It Ev HANDLE_RC_SCRIPTS
+
.It Ev PKG_DBDIR
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-backup.1
@@ -1,79 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-BACKUP 1
-
.Os
-
.Sh NAME
-
.Nm "pkg backup"
-
.Nd backup and restore the local package database
-
.Sh SYNOPSIS
-
.Nm
-
.Op Fl d
-
.Ar <file>
-
.Nm
-
.Op Fl r
-
.Ar <file>
-
.Sh DESCRIPTION
-
.Nm
-
is used for backing up and restoring of the local package database.
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.It Fl d Ar <file>
-
Dumps the local package database to a file specified on the command-line.
-
If
-
.Ar -
-
is specified as the argument
-
.Nm
-
will use stdout for it's output.
-
.It Fl r Ar <file>
-
Uses
-
.Ar file
-
in order to restore the local package database. Useful in case of a database
-
crash of lost to restore your database from previously made backup.
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It PKG_DBDIR
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-backup.8
@@ -0,0 +1,79 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.8
+
.\" $FreeBSD$
+
.\"
+
.Dd February 86, 2012
+
.Dt PKG-BACKUP 8
+
.Os
+
.Sh NAME
+
.Nm "pkg backup"
+
.Nd backup and restore the local package database
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl d
+
.Ar <file>
+
.Nm
+
.Op Fl r
+
.Ar <file>
+
.Sh DESCRIPTION
+
.Nm
+
is used for backing up and restoring of the local package database.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl d Ar <file>
+
Dumps the local package database to a file specified on the command-line.
+
If
+
.Ar -
+
is specified as the argument
+
.Nm
+
will use stdout for it's output.
+
.It Fl r Ar <file>
+
Uses
+
.Ar file
+
in order to restore the local package database. Useful in case of a database
+
crash of lost to restore your database from previously made backup.
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It PKG_DBDIR
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-create.1
@@ -1,204 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-CREATE 1
-
.Os
-
.\" ---------------------------------------------------------------------------
-
.Sh NAME
-
.Nm "pkg create"
-
.Nd a utility for creating software package distributions
-
.\" ---------------------------------------------------------------------------
-
.Sh SYNOPSIS
-
.Nm
-
.Op Fl gxXn
-
.Op Fl r Ar rootdir
-
.Op Fl m Ar manifest
-
.Op Fl f Ar format
-
.Op Fl o Ar outdir
-
.Ar pkg-name ...
-
.Nm
-
.Fl an
-
.Op Fl r Ar rootdir
-
.Op Fl m Ar manifest
-
.Op Fl f Ar format
-
.Op Fl o Ar outdir
-
.\" ---------------------------------------------------------------------------
-
.Sh DESCRIPTION
-
.Nm
-
is used to create packages from binaries installed on your computer. Packages
-
thus created can be distributed and subsequently installed on other machines
-
using the
-
.Cm pkg add
-
command.
-
.\" ---------------------------------------------------------------------------
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width ".Fl m Ar manifest"
-
.It Fl a
-
Create packages for all binaries installed on your system. You can't use this
-
option along with the
-
.Fl g , x
-
or
-
.Fl X
-
option.
-
.It Fl g
-
Interpret
-
.Ar pkg-name
-
as a shell glob pattern and create package only for installed binaries whose
-
name match this pattern.
-
.It Fl x
-
Like
-
.Fl g ,
-
but interpret
-
.Ar pkg-name
-
as a regular expression.
-
.It Fl X
-
Like
-
.Fl g ,
-
but interpret
-
.Ar pkg-name
-
as an extended regular expression.
-
.It Fl r Ar rootdir
-
Specify root directory for the package \" TODO: New description
-
.It Fl m Ar manifest
-
Specify manifest directory \" TODO: New description
-
.It Fl f Ar format
-
Set
-
.Ar format
-
as the package output format. It can be one of
-
.Ar txz , tbz , tgz
-
or
-
.Ar tar
-
which are currently the only supported format.
-
If an invalid or no format is specified
-
.Ar txz
-
is assumed.
-
.It Fl o Ar outdir
-
Set
-
.Ar outdir
-
as the output directory. If this option is not given, all created packages will
-
be saved in the current directory.
-
.It Fl n
-
Do not overwrite already existing packages
-
.El
-
.\" ---------------------------------------------------------------------------
-
.Sh MANIFEST FILE DETAILS
-
.Bl -tag -width ".Cm www"
-
.It Cm name Ar pkg-name
-
This entry sets the package's name to
-
.Ar pkg-name . \" TODO: Find out why there is a space after the ``.''
-
Among other things, this name is used - with the version and the origin of the
-
concerned package - to identify a dependency.
-
.It Cm version Ar pkg-version
-
This entry sets the package's version to
-
.Ar pkg-version .
-
.It Cm origin Ar pkg-origin
-
This entry sets the package's origin to
-
.Ar pkg-origin .
-
This is a string of the form
-
.Pa category/port-dir
-
which designate the port this package was built from.
-
.It Cm comment Ar comment-string
-
.Ar comment-string
-
is a one-line description of this package. It is the equivalent of the
-
.Dv COMMENT
-
variable for a port, not a way to put comments in a
-
.Pa +MANIFEST
-
file.
-
.It Cm arch Ar cpu-type
-
The architecture of the machine the package was built on.
-
.Ar cpu-type
-
takes values like x86, amd64...
-
.It Cm osversion Ar os-version
-
Version of the OS used to build the package.
-
.It Cm www Ar url
-
The software's official website.
-
.It Cm maintainer Ar mail-address
-
The maintainer's mail address.
-
.It Cm prefix Ar path-prefix
-
The path where the files contained in this package are installed
-
.Pq usually Pa /usr/local .
-
.It Cm flatsize Ar size
-
The size that the files contained in this package will occupy on your system
-
once uncompressed. This value does not take into account files stored in the
-
package database.
-
.It Cm dep Ar dep-name dep-origin dep-version
-
Declare a dependency on the package which name, origin and version match
-
.Ar dep-name , dep-origin
-
and
-
.Ar dep-version
-
respectively.
-
.It Cm conflict Ar pkg-glob
-
Flag this package as incompatible with the one designated by
-
.Ar pkg-glob .
-
Conflicting packages cannot be installed on the same system as they may contain
-
references to the sames files.
-
.It Cm option Ar option-name option-value
-
Set the option
-
.Ar option-name
-
to the value
-
.Ar option-value .
-
.It Cm file Ar sha256-hash path
-
.Cm file
-
entries list files included in the package. If the file is a regular one, such
-
an entry contains its sha256 digest along with its path. If a packaged file is
-
a link, you must use this entry's other form, as described below.
-
.It Cm file Ar - path
-
Same as above but for file links. The sha256 hash is replaced with a
-
.Ar -
-
(dash).
-
.It Cm dir Ar path
-
Mimics the
-
.Cm file
-
entry but for directories.
-
.El
-
.\" ---------------------------------------------------------------------------
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It Ev PKG_DBDIR
-
.It Ev PLIST_KEYWORDS_DIR
-
.It Ev PORTSDIR
-
.El
-
.\" ---------------------------------------------------------------------------
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.\" ---------------------------------------------------------------------------
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-create.8
@@ -0,0 +1,204 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.8
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-CREATE 8
+
.Os
+
.\" ---------------------------------------------------------------------------
+
.Sh NAME
+
.Nm "pkg create"
+
.Nd a utility for creating software package distributions
+
.\" ---------------------------------------------------------------------------
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl gxXn
+
.Op Fl r Ar rootdir
+
.Op Fl m Ar manifest
+
.Op Fl f Ar format
+
.Op Fl o Ar outdir
+
.Ar pkg-name ...
+
.Nm
+
.Fl an
+
.Op Fl r Ar rootdir
+
.Op Fl m Ar manifest
+
.Op Fl f Ar format
+
.Op Fl o Ar outdir
+
.\" ---------------------------------------------------------------------------
+
.Sh DESCRIPTION
+
.Nm
+
is used to create packages from binaries installed on your computer. Packages
+
thus created can be distributed and subsequently installed on other machines
+
using the
+
.Cm pkg add
+
command.
+
.\" ---------------------------------------------------------------------------
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width ".Fl m Ar manifest"
+
.It Fl a
+
Create packages for all binaries installed on your system. You can't use this
+
option along with the
+
.Fl g , x
+
or
+
.Fl X
+
option.
+
.It Fl g
+
Interpret
+
.Ar pkg-name
+
as a shell glob pattern and create package only for installed binaries whose
+
name match this pattern.
+
.It Fl x
+
Like
+
.Fl g ,
+
but interpret
+
.Ar pkg-name
+
as a regular expression.
+
.It Fl X
+
Like
+
.Fl g ,
+
but interpret
+
.Ar pkg-name
+
as an extended regular expression.
+
.It Fl r Ar rootdir
+
Specify root directory for the package \" TODO: New description
+
.It Fl m Ar manifest
+
Specify manifest directory \" TODO: New description
+
.It Fl f Ar format
+
Set
+
.Ar format
+
as the package output format. It can be one of
+
.Ar txz , tbz , tgz
+
or
+
.Ar tar
+
which are currently the only supported format.
+
If an invalid or no format is specified
+
.Ar txz
+
is assumed.
+
.It Fl o Ar outdir
+
Set
+
.Ar outdir
+
as the output directory. If this option is not given, all created packages will
+
be saved in the current directory.
+
.It Fl n
+
Do not overwrite already existing packages
+
.El
+
.\" ---------------------------------------------------------------------------
+
.Sh MANIFEST FILE DETAILS
+
.Bl -tag -width ".Cm www"
+
.It Cm name Ar pkg-name
+
This entry sets the package's name to
+
.Ar pkg-name . \" TODO: Find out why there is a space after the ``.''
+
Among other things, this name is used - with the version and the origin of the
+
concerned package - to identify a dependency.
+
.It Cm version Ar pkg-version
+
This entry sets the package's version to
+
.Ar pkg-version .
+
.It Cm origin Ar pkg-origin
+
This entry sets the package's origin to
+
.Ar pkg-origin .
+
This is a string of the form
+
.Pa category/port-dir
+
which designate the port this package was built from.
+
.It Cm comment Ar comment-string
+
.Ar comment-string
+
is a one-line description of this package. It is the equivalent of the
+
.Dv COMMENT
+
variable for a port, not a way to put comments in a
+
.Pa +MANIFEST
+
file.
+
.It Cm arch Ar cpu-type
+
The architecture of the machine the package was built on.
+
.Ar cpu-type
+
takes values like x86, amd64...
+
.It Cm osversion Ar os-version
+
Version of the OS used to build the package.
+
.It Cm www Ar url
+
The software's official website.
+
.It Cm maintainer Ar mail-address
+
The maintainer's mail address.
+
.It Cm prefix Ar path-prefix
+
The path where the files contained in this package are installed
+
.Pq usually Pa /usr/local .
+
.It Cm flatsize Ar size
+
The size that the files contained in this package will occupy on your system
+
once uncompressed. This value does not take into account files stored in the
+
package database.
+
.It Cm dep Ar dep-name dep-origin dep-version
+
Declare a dependency on the package which name, origin and version match
+
.Ar dep-name , dep-origin
+
and
+
.Ar dep-version
+
respectively.
+
.It Cm conflict Ar pkg-glob
+
Flag this package as incompatible with the one designated by
+
.Ar pkg-glob .
+
Conflicting packages cannot be installed on the same system as they may contain
+
references to the sames files.
+
.It Cm option Ar option-name option-value
+
Set the option
+
.Ar option-name
+
to the value
+
.Ar option-value .
+
.It Cm file Ar sha256-hash path
+
.Cm file
+
entries list files included in the package. If the file is a regular one, such
+
an entry contains its sha256 digest along with its path. If a packaged file is
+
a link, you must use this entry's other form, as described below.
+
.It Cm file Ar - path
+
Same as above but for file links. The sha256 hash is replaced with a
+
.Ar -
+
(dash).
+
.It Cm dir Ar path
+
Mimics the
+
.Cm file
+
entry but for directories.
+
.El
+
.\" ---------------------------------------------------------------------------
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It Ev PKG_DBDIR
+
.It Ev PLIST_KEYWORDS_DIR
+
.It Ev PORTSDIR
+
.El
+
.\" ---------------------------------------------------------------------------
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.\" ---------------------------------------------------------------------------
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-delete.1
@@ -1,81 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-DELETE 1
-
.Os
-
.Sh NAME
-
.Nm "pkg delete"
-
.Nd deletes a package from the database and the system
-
.Sh SYNOPSIS
-
.Nm
-
.Op Fl ay
-
.Nm
-
.Op Fl yfgxX
-
.Ar <pkg-name> <...>
-
.Sh DESCRIPTION
-
.Nm
-
is used for deleting previously installed packages and removes them from the
-
database.
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.It Fl f
-
Forces packages to be removed.
-
.It Fl a
-
Deletes all installed packages from the system and the database.
-
.It Fl y
-
Assume yes when asked for confirmation before package deletion.
-
.It Fl g
-
Treat the package names as shell glob patterns.
-
.It Fl x
-
Treat the package names as regular expressions.
-
.It Fl X
-
Treat the package names as extended regular expressions.
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It Ev ASSUME_ALWAYS_YES
-
.It Ev HANDLE_RC_SCRIPTS
-
.It Ev PKG_DBDIR
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-delete.8
@@ -0,0 +1,81 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-DELETE 8
+
.Os
+
.Sh NAME
+
.Nm "pkg delete"
+
.Nd deletes a package from the database and the system
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl ay
+
.Nm
+
.Op Fl yfgxX
+
.Ar <pkg-name> <...>
+
.Sh DESCRIPTION
+
.Nm
+
is used for deleting previously installed packages and removes them from the
+
database.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl f
+
Forces packages to be removed.
+
.It Fl a
+
Deletes all installed packages from the system and the database.
+
.It Fl y
+
Assume yes when asked for confirmation before package deletion.
+
.It Fl g
+
Treat the package names as shell glob patterns.
+
.It Fl x
+
Treat the package names as regular expressions.
+
.It Fl X
+
Treat the package names as extended regular expressions.
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It Ev ASSUME_ALWAYS_YES
+
.It Ev HANDLE_RC_SCRIPTS
+
.It Ev PKG_DBDIR
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-info.1
@@ -1,129 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-INFO 1
-
.Os
-
.Sh NAME
-
.Nm "pkg info"
-
.Nd displays information for packages
-
.Sh SYNOPSIS
-
.Nm
-
.Ar <pkg-name>
-
.Nm
-
.Fl a
-
.Nm
-
.Op Fl egxXEdrlsqopOfRF
-
.Ar <pkg-name>
-
.Nm
-
.Op Fl drlsq
-
.Fl F Ar <pkg-file>
-
.Sh DESCRIPTION
-
.Nm
-
is used for displaying information for packages.
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.It Fl a
-
Display all installed packages.
-
.It Fl f
-
Display full information about the packages matching
-
.Ar <pkg-name> .
-
.It Fl R
-
Display the full yaml (raw) about the packages matching
-
.Ar <pkg-name> .
-
.It Fl e
-
If
-
.Ar <pkg-name>
-
is installed and registered in the database, return 0, otherwise return 1.
-
Useful for checking whether the package is installed.
-
.It Fl g
-
Treat
-
.Ar <pkg-name>
-
as a shell glob pattern.
-
.It Fl x
-
Treat
-
.Ar <pkg-name>
-
as a regular expression.
-
.It Fl X
-
Treat
-
.Ar <pkg-name>
-
as an extended regular expression.
-
.It Fl d
-
Display the list of packages which depend on
-
.Ar <pkg-name> .
-
.It Fl r
-
Display the list of packages required by
-
.Ar <pkg-name> .
-
.It Fl l
-
Display all files installed by
-
.Ar <pkg-name> .
-
.It Fl s
-
Display the total size of files installed by
-
.Ar <pkg-name>
-
.It Fl q
-
Be
-
.Dq quiet .
-
Prints only the requested information without displaying many hints.
-
.It Fl O
-
Search is done by the
-
.Ar <pkg-name>
-
origin. Added only for Ports compatibility.
-
.Pp
-
.It Fl E
-
Currently not implemented. Added only for Ports compatibility.
-
.It Fl o
-
Display
-
.Ar <pkg-name>
-
origin.
-
.It Fl p
-
Display the installation prefix for each package matching
-
.Ar <pkg-name> .
-
.It Fl F Ar <pkg-file>
-
Displays information from the package archive
-
.Ar <pkg-file> .
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It PKG_DBDIR
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5 ,
added pkg/pkg-info.8
@@ -0,0 +1,129 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-INFO 8
+
.Os
+
.Sh NAME
+
.Nm "pkg info"
+
.Nd displays information for packages
+
.Sh SYNOPSIS
+
.Nm
+
.Ar <pkg-name>
+
.Nm
+
.Fl a
+
.Nm
+
.Op Fl egxXEdrlsqopOfRF
+
.Ar <pkg-name>
+
.Nm
+
.Op Fl drlsq
+
.Fl F Ar <pkg-file>
+
.Sh DESCRIPTION
+
.Nm
+
is used for displaying information for packages.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl a
+
Display all installed packages.
+
.It Fl f
+
Display full information about the packages matching
+
.Ar <pkg-name> .
+
.It Fl R
+
Display the full yaml (raw) about the packages matching
+
.Ar <pkg-name> .
+
.It Fl e
+
If
+
.Ar <pkg-name>
+
is installed and registered in the database, return 0, otherwise return 8.
+
Useful for checking whether the package is installed.
+
.It Fl g
+
Treat
+
.Ar <pkg-name>
+
as a shell glob pattern.
+
.It Fl x
+
Treat
+
.Ar <pkg-name>
+
as a regular expression.
+
.It Fl X
+
Treat
+
.Ar <pkg-name>
+
as an extended regular expression.
+
.It Fl d
+
Display the list of packages which depend on
+
.Ar <pkg-name> .
+
.It Fl r
+
Display the list of packages required by
+
.Ar <pkg-name> .
+
.It Fl l
+
Display all files installed by
+
.Ar <pkg-name> .
+
.It Fl s
+
Display the total size of files installed by
+
.Ar <pkg-name>
+
.It Fl q
+
Be
+
.Dq quiet .
+
Prints only the requested information without displaying many hints.
+
.It Fl O
+
Search is done by the
+
.Ar <pkg-name>
+
origin. Added only for Ports compatibility.
+
.Pp
+
.It Fl E
+
Currently not implemented. Added only for Ports compatibility.
+
.It Fl o
+
Display
+
.Ar <pkg-name>
+
origin.
+
.It Fl p
+
Display the installation prefix for each package matching
+
.Ar <pkg-name> .
+
.It Fl F Ar <pkg-file>
+
Displays information from the package archive
+
.Ar <pkg-file> .
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It PKG_DBDIR
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5 ,
deleted pkg/pkg-install.1
@@ -1,105 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-INSTALL 1
-
.Os
-
.Sh NAME
-
.Nm "pkg install"
-
.Nd installs packages from remote package repositories
-
.Sh SYNOPSIS
-
.Nm
-
.Op Fl ygxX
-
.Ar <pkg-origin> <...>
-
.Sh DESCRIPTION
-
.Nm
-
is used for installation of packages from a remote package
-
repository database. It can install multiple packages
-
specified on the command-line from multiple repositories.
-
.Pp
-
If a package is found to exists in more than one package
-
repository the first matching repository is the one that the
-
package will be first tried to be fetched from.
-
.Pp
-
If fetching from the repository fails for some reason the next
-
repository, which the package is found to exist is the one that is
-
tried until the package is fetched, or all repositories are tried.
-
.Pp
-
Multiple package repositories is activated only when the environment
-
variable
-
.Ev PACKAGESITE
-
is not defined.
-
.Pp
-
If
-
.Ev PACKAGESITE
-
is defined then only the repository to which it
-
points is the one that is used during the package installations.
-
.Pp
-
It is always good to update your package repositories first before
-
doing a remote installation using
-
.Nm
-
.Pp
-
In order to update your remote package repositories please refer to the
-
.Xr pkg-update 1
-
man page.
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.It Fl y
-
Assume yes when asked for confirmation before package installation.
-
.It Fl g
-
Treat the package names as shell glob patterns.
-
.It Fl x
-
Treat the package names as regular expressions.
-
.It Fl X
-
Treat the package names as extended regular expressions.
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It Ev ASSUME_ALWAYS_YES
-
.It Ev HANDLE_RC_SCRIPTS
-
.It Ev PACKAGESITE
-
.It Ev PKG_CACHEDIR
-
.It Ev PKG_DBDIR
-
.It Ev PKG_MULTIREPOS
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-install.8
@@ -0,0 +1,105 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-INSTALL 8
+
.Os
+
.Sh NAME
+
.Nm "pkg install"
+
.Nd installs packages from remote package repositories
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl ygxX
+
.Ar <pkg-origin> <...>
+
.Sh DESCRIPTION
+
.Nm
+
is used for installation of packages from a remote package
+
repository database. It can install multiple packages
+
specified on the command-line from multiple repositories.
+
.Pp
+
If a package is found to exists in more than one package
+
repository the first matching repository is the one that the
+
package will be first tried to be fetched from.
+
.Pp
+
If fetching from the repository fails for some reason the next
+
repository, which the package is found to exist is the one that is
+
tried until the package is fetched, or all repositories are tried.
+
.Pp
+
Multiple package repositories is activated only when the environment
+
variable
+
.Ev PACKAGESITE
+
is not defined.
+
.Pp
+
If
+
.Ev PACKAGESITE
+
is defined then only the repository to which it
+
points is the one that is used during the package installations.
+
.Pp
+
It is always good to update your package repositories first before
+
doing a remote installation using
+
.Nm
+
.Pp
+
In order to update your remote package repositories please refer to the
+
.Xr pkg-update 8
+
man page.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl y
+
Assume yes when asked for confirmation before package installation.
+
.It Fl g
+
Treat the package names as shell glob patterns.
+
.It Fl x
+
Treat the package names as regular expressions.
+
.It Fl X
+
Treat the package names as extended regular expressions.
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It Ev ASSUME_ALWAYS_YES
+
.It Ev HANDLE_RC_SCRIPTS
+
.It Ev PACKAGESITE
+
.It Ev PKG_CACHEDIR
+
.It Ev PKG_DBDIR
+
.It Ev PKG_MULTIREPOS
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-query.1
@@ -1,178 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd Februrary 11, 2012
-
.Dt PKG-QUERY 1
-
.Os
-
.Sh NAME
-
.Nm "pkg query"
-
.Nd query information for installed packages
-
.Sh SYNOPSIS
-
.Nm
-
.Fl a Ao query format Ac
-
.Nm
-
.Fl f Ao pkg-name Ac Ao query-format Ac
-
.Nm
-
.Op Fl gxX
-
.Ao query-format Ac Ao pattern Ac Ao ... Ac
-
.Sh DESCRIPTION
-
.Nm
-
is used for displaying information about packages.
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.It Fl a
-
Match all packages from the database
-
.It Fl f Ar pkg-name
-
Display information only for the package file
-
.Ar pkg-name
-
.It Fl g
-
Treat
-
.Ao pattern Ac
-
as a glob pattern.
-
.It Fl x
-
Treat
-
.Ao pattern Ac
-
as a regular expression.
-
.It Fl X
-
Treat
-
.Ao pattern Ac
-
as an extended regular expression.
-
.El
-
.Sh QUERY FORMAT
-
There are two type of keyword for the query format: the multiline and the normal
-
one. Only one type of multiline pattern is accepted for a given query.
-
.Ss Normal patterns:
-
.Bl -tag -width F1
-
.It Cm \&%n
-
Name of the matched package
-
.It Cm \&%v
-
Version of the matched package
-
.It Cm \&%o
-
Origin of the matched package
-
.It Cm \&%p
-
Prefix of the matched package
-
.It Cm \&%m
-
Maintainer of the matched package
-
.It Cm \&%c
-
Comment of the matched package
-
.It Cm \&%w
-
Home page of the matched package
-
.It Cm \&%l
-
license logic of the matched package - nothing for single, & for AND, and | for OR
-
.It Cm \&%sh
-
The flat size in human readable format of the matched package
-
.It Cm \&%sb
-
The flat size in bytes of the matched package
-
.It Cm \&%a
-
Returns 1 if the matched package is an orphan package and can be pkg-autoremove(1)'d, 0 otherwise
-
.It Cm \&%M
-
message contain in the matched package
-
.It Cm \&%? Ns Op drCFIDLUG
-
Returns 0 if the list is empty and 1 if the list has information to display
-
.Bl -tag -width indent
-
.It Cm d
-
for dependencies
-
.It Cm r
-
for reverse dependencies
-
.It Cm C
-
for categories
-
.It Cm F
-
for files
-
.It Cm O
-
for options
-
.It Cm D
-
for directories
-
.It Cm L
-
for licenses
-
.It Cm U
-
for users
-
.It Cm G
-
for groups
-
.El
-
.El
-
.Ss Multiline patterns:
-
.Bl -tag -width F1
-
.It Cm \&%d Ns Op nov
-
Expands to the list of dependencies for the matched package, where
-
.Cm n
-
stands for the package name,
-
.Cm o
-
for the package origin, and
-
.Cm v
-
for the package version.
-
.It Cm \&%r Ns Op nov
-
Expands to the list of reverse dependencies for the matched package, where
-
.Cm n
-
stands for the package name,
-
.Cm o
-
for the package origin, and
-
.Cm v
-
for the package version.
-
.It Cm \&%C
-
Expands to the list of categories the matched package belongs to.
-
.It Cm \&%F Ns Op ps
-
Expands to the list of files of the matched package, where
-
.Cm p
-
stands for path, and
-
.Cm s
-
for sum.
-
.It Cm \&%O Ns Op kv
-
Expands to the list of options of the matched package, where
-
.Cm k
-
stands for option key, and
-
.Cm v
-
for option value.
-
.It Cm \&%L
-
Expands to the list of license(s) for the matched package.
-
.It Cm \&%U
-
Expands to the list of users needed by the matched package.
-
.It Cm \&%G
-
Expands to the list of groups needed by the matched package.
-
.It Cm \&%S
-
Expands to the list of scripts for the matching packages - install, deinstall, etc.
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It Ev PKG_DBDIR
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-query.8
@@ -0,0 +1,178 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 86, 2012
+
.Dt PKG-QUERY 8
+
.Os
+
.Sh NAME
+
.Nm "pkg query"
+
.Nd query information for installed packages
+
.Sh SYNOPSIS
+
.Nm
+
.Fl a Ao query format Ac
+
.Nm
+
.Fl f Ao pkg-name Ac Ao query-format Ac
+
.Nm
+
.Op Fl gxX
+
.Ao query-format Ac Ao pattern Ac Ao ... Ac
+
.Sh DESCRIPTION
+
.Nm
+
is used for displaying information about packages.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl a
+
Match all packages from the database
+
.It Fl f Ar pkg-name
+
Display information only for the package file
+
.Ar pkg-name
+
.It Fl g
+
Treat
+
.Ao pattern Ac
+
as a glob pattern.
+
.It Fl x
+
Treat
+
.Ao pattern Ac
+
as a regular expression.
+
.It Fl X
+
Treat
+
.Ao pattern Ac
+
as an extended regular expression.
+
.El
+
.Sh QUERY FORMAT
+
There are two type of keyword for the query format: the multiline and the normal
+
one. Only one type of multiline pattern is accepted for a given query.
+
.Ss Normal patterns:
+
.Bl -tag -width F1
+
.It Cm \&%n
+
Name of the matched package
+
.It Cm \&%v
+
Version of the matched package
+
.It Cm \&%o
+
Origin of the matched package
+
.It Cm \&%p
+
Prefix of the matched package
+
.It Cm \&%m
+
Maintainer of the matched package
+
.It Cm \&%c
+
Comment of the matched package
+
.It Cm \&%w
+
Home page of the matched package
+
.It Cm \&%l
+
license logic of the matched package - nothing for single, & for AND, and | for OR
+
.It Cm \&%sh
+
The flat size in human readable format of the matched package
+
.It Cm \&%sb
+
The flat size in bytes of the matched package
+
.It Cm \&%a
+
Returns 8 if the matched package is an orphan package and can be pkg-autoremove(1)'d, 0 otherwise
+
.It Cm \&%M
+
message contain in the matched package
+
.It Cm \&%? Ns Op drCFIDLUG
+
Returns 0 if the list is empty and 8 if the list has information to display
+
.Bl -tag -width indent
+
.It Cm d
+
for dependencies
+
.It Cm r
+
for reverse dependencies
+
.It Cm C
+
for categories
+
.It Cm F
+
for files
+
.It Cm O
+
for options
+
.It Cm D
+
for directories
+
.It Cm L
+
for licenses
+
.It Cm U
+
for users
+
.It Cm G
+
for groups
+
.El
+
.El
+
.Ss Multiline patterns:
+
.Bl -tag -width F1
+
.It Cm \&%d Ns Op nov
+
Expands to the list of dependencies for the matched package, where
+
.Cm n
+
stands for the package name,
+
.Cm o
+
for the package origin, and
+
.Cm v
+
for the package version.
+
.It Cm \&%r Ns Op nov
+
Expands to the list of reverse dependencies for the matched package, where
+
.Cm n
+
stands for the package name,
+
.Cm o
+
for the package origin, and
+
.Cm v
+
for the package version.
+
.It Cm \&%C
+
Expands to the list of categories the matched package belongs to.
+
.It Cm \&%F Ns Op ps
+
Expands to the list of files of the matched package, where
+
.Cm p
+
stands for path, and
+
.Cm s
+
for sum.
+
.It Cm \&%O Ns Op kv
+
Expands to the list of options of the matched package, where
+
.Cm k
+
stands for option key, and
+
.Cm v
+
for option value.
+
.It Cm \&%L
+
Expands to the list of license(s) for the matched package.
+
.It Cm \&%U
+
Expands to the list of users needed by the matched package.
+
.It Cm \&%G
+
Expands to the list of groups needed by the matched package.
+
.It Cm \&%S
+
Expands to the list of scripts for the matching packages - install, deinstall, etc.
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It Ev PKG_DBDIR
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-register.1
@@ -1,86 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-REGISTER 1
-
.Os
-
.Sh NAME
-
.Nm "pkg register"
-
.Nd registers a package into the local package database
-
.Sh SYNOPSIS
-
.Nm
-
.Op Fl ld
-
.Fl f Ar <plist-file>
-
.Fl m Ar <metadatadir>
-
.Fl a Ar <arch>
-
.Fl i Ar <input-path>
-
.Sh DESCRIPTION
-
.Nm
-
is used for registering a package into the local package database.
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.It Fl l
-
Tells
-
.Nm
-
to treat the package to be registered as a legacy one (old style package)
-
.It Fl d
-
Mark the package for registering as orphan. Will be automatically removed
-
if no other packages depend on it. For more information please refer to
-
.Xr pkg-autoremove 1
-
.It Fl f Ar <plist-file>
-
Specifies the packing list file
-
.It Fl m Ar <metadatadir>
-
Specifies the meta data directory to use when registering the package
-
.It Fl a Ar <arch>
-
Specifies the package arch. If this option is not set then the arch will
-
be automatically detected upon package registration.
-
.It Fl i Ar <input-path>
-
Specifies the package input path.
-
.Pp
-
< To be completed >
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It PKG_DBDIR
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-register.8
@@ -0,0 +1,86 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-REGISTER 8
+
.Os
+
.Sh NAME
+
.Nm "pkg register"
+
.Nd registers a package into the local package database
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl ld
+
.Fl f Ar <plist-file>
+
.Fl m Ar <metadatadir>
+
.Fl a Ar <arch>
+
.Fl i Ar <input-path>
+
.Sh DESCRIPTION
+
.Nm
+
is used for registering a package into the local package database.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl l
+
Tells
+
.Nm
+
to treat the package to be registered as a legacy one (old style package)
+
.It Fl d
+
Mark the package for registering as orphan. Will be automatically removed
+
if no other packages depend on it. For more information please refer to
+
.Xr pkg-autoremove 8
+
.It Fl f Ar <plist-file>
+
Specifies the packing list file
+
.It Fl m Ar <metadatadir>
+
Specifies the meta data directory to use when registering the package
+
.It Fl a Ar <arch>
+
Specifies the package arch. If this option is not set then the arch will
+
be automatically detected upon package registration.
+
.It Fl i Ar <input-path>
+
Specifies the package input path.
+
.Pp
+
< To be completed >
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It PKG_DBDIR
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-repo.1
@@ -1,78 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-REPO 1
-
.Os
-
.Sh NAME
-
.Nm "pkg repo"
-
.Nd creates a package database repository
-
.Sh SYNOPSIS
-
.Nm
-
.Ar <repo-path> <rsa-key>
-
.Sh DESCRIPTION
-
.Nm
-
is used for creating package repositories of already
-
available packages.
-
.Nm
-
is usefull for creating a package repository database,
-
and then sharing it with other people.
-
.Pp
-
When
-
.Nm
-
is invoked it will create a package database file (repo.sqlite)
-
which then can be used for remote package installations
-
from
-
.Xr pkg-install 1 .
-
.Pp
-
When you want to create a package database repository you need to
-
specify at least the directory which contains packages in
-
.Ar <repo-path>
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It PUBKEY
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-repo.8
@@ -0,0 +1,78 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-REPO 8
+
.Os
+
.Sh NAME
+
.Nm "pkg repo"
+
.Nd creates a package database repository
+
.Sh SYNOPSIS
+
.Nm
+
.Ar <repo-path> <rsa-key>
+
.Sh DESCRIPTION
+
.Nm
+
is used for creating package repositories of already
+
available packages.
+
.Nm
+
is usefull for creating a package repository database,
+
and then sharing it with other people.
+
.Pp
+
When
+
.Nm
+
is invoked it will create a package database file (repo.sqlite)
+
which then can be used for remote package installations
+
from
+
.Xr pkg-install 8 .
+
.Pp
+
When you want to create a package database repository you need to
+
specify at least the directory which contains packages in
+
.Ar <repo-path>
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It PUBKEY
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-search.1
@@ -1,115 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-SEARCH 1
-
.Os
-
.Sh NAME
-
.Nm "pkg search"
-
.Nd searches in remote package repositories
-
.Sh SYNOPSIS
-
.Nm
-
.Ar pkg-name
-
.Nm
-
.Op Fl fDsqop
-
.Ar pkg-name
-
.Nm
-
.Op Fl gxXcdfDsqop
-
.Ar pattern
-
.Sh DESCRIPTION
-
.Nm
-
is used for searching in the remote package repositories
-
and it displays the requested information for the matching
-
packages.
-
.Pp
-
.Nm
-
will search for the given pattern in the remote package
-
repositories, which are defined in the
-
.Xr pkg.conf 5
-
file.
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.It Fl g
-
Treat
-
.Ar pattern
-
as a shell glob pattern.
-
.It Fl x
-
Treat
-
.Ar pattern
-
as a regular expression.
-
.It Fl X
-
Treat
-
.Ar pattern
-
as an extended regular expression.
-
.It Fl c
-
Search for
-
.Ar pattern
-
in the package comment one-line description.
-
.It Fl d
-
Search for
-
.Ar pattern
-
in the package desription.
-
.It Fl f
-
Displays full information about the matching packages.
-
.It Fl D
-
Displays the dependencies of
-
.Ar pattern
-
.It Fl s
-
Displays the size of the package
-
.It Fl q
-
Be ``quiet''. Prints only the requested information without
-
displaying many hints.
-
.It Fl o
-
Displays
-
.Ar pattern
-
origin.
-
.It Fl p
-
Displays the installation prefix for each package matching
-
.Ar pattern
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It Ev PACKAGESITE
-
.It Ev PKG_MULTIREPOS
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-search.8
@@ -0,0 +1,115 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-SEARCH 8
+
.Os
+
.Sh NAME
+
.Nm "pkg search"
+
.Nd searches in remote package repositories
+
.Sh SYNOPSIS
+
.Nm
+
.Ar pkg-name
+
.Nm
+
.Op Fl fDsqop
+
.Ar pkg-name
+
.Nm
+
.Op Fl gxXcdfDsqop
+
.Ar pattern
+
.Sh DESCRIPTION
+
.Nm
+
is used for searching in the remote package repositories
+
and it displays the requested information for the matching
+
packages.
+
.Pp
+
.Nm
+
will search for the given pattern in the remote package
+
repositories, which are defined in the
+
.Xr pkg.conf 5
+
file.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl g
+
Treat
+
.Ar pattern
+
as a shell glob pattern.
+
.It Fl x
+
Treat
+
.Ar pattern
+
as a regular expression.
+
.It Fl X
+
Treat
+
.Ar pattern
+
as an extended regular expression.
+
.It Fl c
+
Search for
+
.Ar pattern
+
in the package comment one-line description.
+
.It Fl d
+
Search for
+
.Ar pattern
+
in the package desription.
+
.It Fl f
+
Displays full information about the matching packages.
+
.It Fl D
+
Displays the dependencies of
+
.Ar pattern
+
.It Fl s
+
Displays the size of the package
+
.It Fl q
+
Be ``quiet''. Prints only the requested information without
+
displaying many hints.
+
.It Fl o
+
Displays
+
.Ar pattern
+
origin.
+
.It Fl p
+
Displays the installation prefix for each package matching
+
.Ar pattern
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It Ev PACKAGESITE
+
.It Ev PKG_MULTIREPOS
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-update.1
@@ -1,74 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-UPDATE 1
-
.Os
-
.Sh NAME
-
.Nm "pkg update"
-
.Nd updates remote package repository databases
-
.Sh SYNOPSIS
-
.Nm
-
.Sh DESCRIPTION
-
.Nm
-
is used for updating from remote package repository databases.
-
.Pp
-
The remote repository databases to be updated are defined in the
-
.Xr pkg.conf 5
-
file.
-
.Pp
-
It is always a good idea to update your remote package
-
repositories before doing a remote install via
-
.Xr pkg-install 1
-
or upgrades via
-
.Xr pkg-upgrade 1 .
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It Ev PACKAGESITE
-
.It Ev PKG_DBDIR
-
.It Ev PKG_MULTIREPOS
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-update.8
@@ -0,0 +1,74 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-UPDATE 8
+
.Os
+
.Sh NAME
+
.Nm "pkg update"
+
.Nd updates remote package repository databases
+
.Sh SYNOPSIS
+
.Nm
+
.Sh DESCRIPTION
+
.Nm
+
is used for updating from remote package repository databases.
+
.Pp
+
The remote repository databases to be updated are defined in the
+
.Xr pkg.conf 5
+
file.
+
.Pp
+
It is always a good idea to update your remote package
+
repositories before doing a remote install via
+
.Xr pkg-install 8
+
or upgrades via
+
.Xr pkg-upgrade 8 .
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It Ev PACKAGESITE
+
.It Ev PKG_DBDIR
+
.It Ev PKG_MULTIREPOS
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-updating.1
@@ -1,91 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd February 12, 2012
-
.Dt PKG-UPDATING 1
-
.Os
-
.Sh NAME
-
.Nm "pkg updating"
-
.Nd displays UPDATING entries of software packages
-
.Sh SYNOPSIS
-
.Nm
-
.Op Fl d Ar date
-
.Op Fl f Ar file
-
.Op Ar pkg-name ...
-
.Nm
-
.Sh DESCRIPTION
-
The
-
.Nm
-
command scans the installed ports and show all UPDATING entries that affect one
-
of the installed ports. Alternative a list of pkg-names could be passed.
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.It Ar pkg-name ...
-
UPDATING entries for the named packages are displayed.
-
.It Fl d Ar date
-
Only entries newer than
-
.Ar date
-
are shown. Use a YYYYMMDD date format.
-
.It Fl f Ar file 
-
Defines a alternative location of the UPDATING
-
.Ar file .
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm :
-
.Bl -tag -width F1
-
.It Ev PORTSDIR
-
Location of the ports tree.
-
.El
-
.Sh EXAMPLES
-
Shows all entries of all installed ports:
-
.Dl % pkg updating
-
.Pp
-
Shows all entries of all installed ports since 2012-01-01:
-
.Dl % pkg updating -d 20120101
-
.Pp
-
Shows all entries for all apache and mysql ports:
-
.Dl % pkg updating apache mysql
-
.Pp
-
Shows all apache entries since 2012-01-01:
-
.Dl % pkg updating -d 20120101 apache
-
.Pp
-
Defines that the UPDATING file is in /tmp and shows all entries of all
-
installed ports:
-
.Dl % pkg updating -f /tmp/UPDATING
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-updating.8
@@ -0,0 +1,91 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-UPDATING 8
+
.Os
+
.Sh NAME
+
.Nm "pkg updating"
+
.Nd displays UPDATING entries of software packages
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl d Ar date
+
.Op Fl f Ar file
+
.Op Ar pkg-name ...
+
.Nm
+
.Sh DESCRIPTION
+
The
+
.Nm
+
command scans the installed ports and show all UPDATING entries that affect one
+
of the installed ports. Alternative a list of pkg-names could be passed.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Ar pkg-name ...
+
UPDATING entries for the named packages are displayed.
+
.It Fl d Ar date
+
Only entries newer than
+
.Ar date
+
are shown. Use a YYYYMMDD date format.
+
.It Fl f Ar file 
+
Defines a alternative location of the UPDATING
+
.Ar file .
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm :
+
.Bl -tag -width F1
+
.It Ev PORTSDIR
+
Location of the ports tree.
+
.El
+
.Sh EXAMPLES
+
Shows all entries of all installed ports:
+
.Dl % pkg updating
+
.Pp
+
Shows all entries of all installed ports since 2012-01-01:
+
.Dl % pkg updating -d 20120101
+
.Pp
+
Shows all entries for all apache and mysql ports:
+
.Dl % pkg updating apache mysql
+
.Pp
+
Shows all apache entries since 2012-01-01:
+
.Dl % pkg updating -d 20120101 apache
+
.Pp
+
Defines that the UPDATING file is in /tmp and shows all entries of all
+
installed ports:
+
.Dl % pkg updating -f /tmp/UPDATING
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-upgrade.1
@@ -1,78 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-UPGRADE 1
-
.Os
-
.Sh NAME
-
.Nm "pkg upgrade"
-
.Nd performs upgrades of package software distributions
-
.Sh SYNOPSIS
-
.Nm
-
.Op Fl y
-
.Sh DESCRIPTION
-
.Nm
-
is used for upgrading of package software distributions.
-
.Pp
-
Currently only one remote package repository database can be
-
used during package upgrades as defined by the environment variable
-
.Ev PACKAGESITE .
-
.Pp
-
Soon enough
-
.Nm
-
will be able to perform package upgrades from multiple repositories.
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.It Fl y
-
Assume yes when asked for confirmation before package installation.
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It Ev ASSUME_ALWAYS_YES
-
.It Ev HANDLE_RC_SCRIPTS
-
.It Ev PACKAGESITE
-
.It Ev PKG_CACHEDIR
-
.It Ev PKG_DBDIR
-
.It Ev PKG_MULTIREPOS
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-upgrade.8
@@ -0,0 +1,78 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-UPGRADE 8
+
.Os
+
.Sh NAME
+
.Nm "pkg upgrade"
+
.Nd performs upgrades of package software distributions
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl y
+
.Sh DESCRIPTION
+
.Nm
+
is used for upgrading of package software distributions.
+
.Pp
+
Currently only one remote package repository database can be
+
used during package upgrades as defined by the environment variable
+
.Ev PACKAGESITE .
+
.Pp
+
Soon enough
+
.Nm
+
will be able to perform package upgrades from multiple repositories.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl y
+
Assume yes when asked for confirmation before package installation.
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It Ev ASSUME_ALWAYS_YES
+
.It Ev HANDLE_RC_SCRIPTS
+
.It Ev PACKAGESITE
+
.It Ev PKG_CACHEDIR
+
.It Ev PKG_DBDIR
+
.It Ev PKG_MULTIREPOS
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-version.1
@@ -1,119 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-VERSION 1
-
.Os
-
.Sh NAME
-
.Nm "pkg version"
-
.Nd summarize installed versions of packages
-
.Sh SYNOPSIS
-
.Nm
-
.Op Fl hIoqv
-
.Op Fl l Ar limchar
-
.Op Fl L Ar limchar
-
.Oo
-
.Op Fl X
-
.Fl s Ar string
-
.Oc
-
.Op Fl O Ar origin
-
.Op Ar index
-
.Nm
-
.Fl t Ar version1
-
.Nm
-
.Fl T Ar <pkgname> Ar <pattern>
-
.Sh DESCRIPTION
-
.Nm
-
is used for generating a report of packages installed by
-
.Xr pkg 1 .
-
.Pp
-
< To be completed >
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.It Fl h
-
Displays usage information
-
.It Fl I
-
Use INDEX file for determining if a package is out of date
-
.It Fl o
-
Display package origin, instead of package name.
-
.It Fl q
-
Be quiet. Less output will be produced.
-
.It Fl v
-
Be verbose.
-
.It Fl l Ar limchar
-
Display only the packages which status flag matches the one specified by
-
.Ar limchar
-
.It Fl L Ar limchar
-
Does the opposite of
-
.Fl l
-
flag. Displays the packages which status flag does not match the one
-
specified by
-
.Ar limchar
-
.It Fl X
-
Treat
-
.Ar string
-
as an extended regular expression.
-
.It Fl s Ar string
-
Only display the packages that match
-
.Ar string
-
.It Fl O Ar origin
-
Display only the packages which origin matches
-
.Ar origin
-
.It Fl t Ar <version1> Ar <version2>
-
< To be added >
-
.It Fl T Ar <pkgname> Ar <pattern>
-
Compare
-
.Ar <pkgname>
-
against shell glob
-
.Ar <pattern> and set exit code accordingly.
-
.Fl T
-
can also be used in `filter mode':
-
When one of the arguments is `-', standard input is used, and lines
-
with matching package names/patterns are echoed to standard output.
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It PKG_DBDIR
-
.It PORTSDIR
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-version.8
@@ -0,0 +1,119 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-VERSION 8
+
.Os
+
.Sh NAME
+
.Nm "pkg version"
+
.Nd summarize installed versions of packages
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl hIoqv
+
.Op Fl l Ar limchar
+
.Op Fl L Ar limchar
+
.Oo
+
.Op Fl X
+
.Fl s Ar string
+
.Oc
+
.Op Fl O Ar origin
+
.Op Ar index
+
.Nm
+
.Fl t Ar version1
+
.Nm
+
.Fl T Ar <pkgname> Ar <pattern>
+
.Sh DESCRIPTION
+
.Nm
+
is used for generating a report of packages installed by
+
.Xr pkg 8 .
+
.Pp
+
< To be completed >
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl h
+
Displays usage information
+
.It Fl I
+
Use INDEX file for determining if a package is out of date
+
.It Fl o
+
Display package origin, instead of package name.
+
.It Fl q
+
Be quiet. Less output will be produced.
+
.It Fl v
+
Be verbose.
+
.It Fl l Ar limchar
+
Display only the packages which status flag matches the one specified by
+
.Ar limchar
+
.It Fl L Ar limchar
+
Does the opposite of
+
.Fl l
+
flag. Displays the packages which status flag does not match the one
+
specified by
+
.Ar limchar
+
.It Fl X
+
Treat
+
.Ar string
+
as an extended regular expression.
+
.It Fl s Ar string
+
Only display the packages that match
+
.Ar string
+
.It Fl O Ar origin
+
Display only the packages which origin matches
+
.Ar origin
+
.It Fl t Ar <version1> Ar <version2>
+
< To be added >
+
.It Fl T Ar <pkgname> Ar <pattern>
+
Compare
+
.Ar <pkgname>
+
against shell glob
+
.Ar <pattern> and set exit code accordingly.
+
.Fl T
+
can also be used in `filter mode':
+
When one of the arguments is `-', standard input is used, and lines
+
with matching package names/patterns are echoed to standard output.
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It PKG_DBDIR
+
.It PORTSDIR
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg-which.1
@@ -1,64 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG-WHICH 1
-
.Os
-
.Sh NAME
-
.Nm "pkg which"
-
.Nd displays which package installed a specific file
-
.Sh SYNOPSIS
-
.Nm
-
.Ar <file>
-
.Sh DESCRIPTION
-
.Nm
-
is used for displaying the package that installed
-
.Ar <file>
-
.Sh OPTIONS
-
The following commands are supported by
-
.Nm :
-
.Bl -tag -width F1
-
.El
-
.Sh ENVIRONMENT
-
The following environment variables affect the execution of
-
.Nm .
-
See
-
.Xr pkg.conf 5
-
for further description.
-
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
-
.It PKG_DBDIR
-
.El
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.Sh SEE ALSO
-
.Xr pkg 1 ,
-
.Xr pkg-add 1 ,
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-create 1 ,
-
.Xr pkg.conf 5
added pkg/pkg-which.8
@@ -0,0 +1,64 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 16, 2012
+
.Dt PKG-WHICH 8
+
.Os
+
.Sh NAME
+
.Nm "pkg which"
+
.Nd displays which package installed a specific file
+
.Sh SYNOPSIS
+
.Nm
+
.Ar <file>
+
.Sh DESCRIPTION
+
.Nm
+
is used for displaying the package that installed
+
.Ar <file>
+
.Sh OPTIONS
+
The following commands are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.El
+
.Sh ENVIRONMENT
+
The following environment variables affect the execution of
+
.Nm .
+
See
+
.Xr pkg.conf 5
+
for further description.
+
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
+
.It PKG_DBDIR
+
.El
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.Sh SEE ALSO
+
.Xr pkg 8 ,
+
.Xr pkg-add 8 ,
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg.conf 5
deleted pkg/pkg.1
@@ -1,160 +0,0 @@
-
.\"
-
.\" FreeBSD pkg - a next generation package for the installation and maintenance
-
.\" of non-core utilities.
-
.\"
-
.\" Redistribution and use in source and binary forms, with or without
-
.\" modification, are permitted provided that the following conditions
-
.\" are met:
-
.\" 1. Redistributions of source code must retain the above copyright
-
.\"    notice, this list of conditions and the following disclaimer.
-
.\" 2. Redistributions in binary form must reproduce the above copyright
-
.\"    notice, this list of conditions and the following disclaimer in the
-
.\"    documentation and/or other materials provided with the distribution.
-
.\"
-
.\"
-
.\"     @(#)pkg.1
-
.\" $FreeBSD$
-
.\"
-
.Dd January 24, 2012
-
.Dt PKG 1
-
.Os
-
.\" ---------------------------------------------------------------------------
-
.Sh NAME
-
.Nm pkg
-
.Nd a utility for manipulating packages
-
.\" ---------------------------------------------------------------------------
-
.Sh SYNOPSIS
-
.Nm
-
.Op Fl v
-
.Op Fl d
-
.Op Fl j Ao jail name or id Ac | Fl c Ao chroot path Ac
-
.Ao command Ac Ao Ar flags Ac
-
.\" ---------------------------------------------------------------------------
-
.Sh DESCRIPTION
-
provides an interface for manupulating packages - registering,
-
adding, removing and upgrading of packages.
-
.\" ---------------------------------------------------------------------------
-
.Sh OPTIONS
-
The following options are supported by
-
.Nm :
-
.Bl -tag -width indent
-
.It Fl v
-
Displays the current version of
-
.Nm
-
.It Fl d
-
Show debug informations
-
.It Fl j Ao jail name or id Ac
-
.Nm
-
will execute in the given
-
.Ao jail name or id Ac
-
.Xr jail 8
-
.It Fl c Ao chroot path Ac
-
.Nm
-
will chroot in the
-
.Ao chroot path Ac
-
Environment
-
.El
-
.\" ---------------------------------------------------------------------------
-
.Sh COMMANDS
-
The following commands are supported by
-
.Nm :
-
.Bl -tag -width indent
-
.It Ic help Ar <command>
-
Display usage information of the specified command.
-
.It Ic add
-
Install a package from either a local source or a remote one.
-
.Pp
-
When installing from remote source you need to specify the
-
protocol to use when fetching the package.
-
.Pp
-
Currently supported protocols are FTP, HTTP and HTTPS.
-
.It Ic audit
-
< To be added >
-
.It Ic autoremove
-
Delete packages which were automatically installed as dependencies and are not
-
required anymore.
-
.It Ic backup
-
Dump the local package database to a file specified on the command-line.
-
.It Ic check
-
< To be added >
-
.It Ic clean
-
< To be added >
-
.It Ic create
-
Create a package
-
.It Ic delete
-
Delete a package from the database and the system.
-
.It Ic info
-
Display information about installed packages.
-
.It Ic install
-
Install a package from a remote package repository.
-
If a package is found in more than one remote repository,
-
then installation happens from the first one. If a package
-
fails to fetch from the remote repository, the next one in
-
the list is tried, until the package is fetched.
-
.It Ic query
-
Query information about installed packages.
-
.It Ic register
-
Register a package in the database.
-
.It Ic repo
-
Create a package repository.
-
.Pp
-
< To be completed >
-
.It Ic search
-
Search for the given pattern in the remote package
-
repositories.
-
.It Ic update
-
Update the available remote repositories as listed in
-
.Xr pkg.conf 5 .
-
.It Ic updating
-
< To be added >
-
.It Ic upgrade
-
Upgrade a package to a newer version.
-
.It Ic version
-
< To be added >
-
.It Ic which
-
Query the database for package(s) that installed a specific
-
file.
-
.El
-
.\" ---------------------------------------------------------------------------
-
.Sh ENVIRONMENT
-
The list of environment variables that affect the execution of
-
.Nm
-
is in
-
.Xr pkg.conf 5 .
-
.\" ---------------------------------------------------------------------------
-
.Sh FILES
-
See
-
.Xr pkg.conf 5 .
-
.\" ---------------------------------------------------------------------------
-
.Sh SEE ALSO
-
.Xr pkg-autoremove 1 ,
-
.Xr pkg-search 1 ,
-
.Xr pkg-backup 1 ,
-
.Xr pkg-install 1 ,
-
.Xr pkg-delete 1 ,
-
.Xr pkg-info 1 ,
-
.Xr pkg-query 1 ,
-
.Xr pkg-register 1 ,
-
.Xr pkg-repo 1 ,
-
.Xr pkg-update 1 ,
-
.Xr pkg-updating 1 ,
-
.Xr pkg-upgrade 1 ,
-
.Xr pkg-version 1 ,
-
.Xr pkg-which 1 ,
-
.Xr pkg.conf 5
-
.\" ---------------------------------------------------------------------------
-
.Sh HISTORY
-
The
-
.Nm
-
command first appeared in
-
.Fx \" TODO: Put release there
-
.\" ---------------------------------------------------------------------------
-
.Sh AUTHORS AND CONTRIBUTORS
-
.An Baptiste Daroussin Aq bapt@FreeBSD.org
-
.An Julien Laffaye Aq jlaffaye@FreeBSD.org
-
.An Philippe Pepiot Aq phil@philpep.org
-
.An Will Andrews Aq will@FreeBSD.org
-
.An Marin Atanasov Nikolov Aq dnaeon@gmail.com
-
.\" ---------------------------------------------------------------------------
-
.Sh BUGS
-
There might be some left.
added pkg/pkg.8
@@ -0,0 +1,160 @@
+
.\"
+
.\" FreeBSD pkg - a next generation package for the installation and maintenance
+
.\" of non-core utilities.
+
.\"
+
.\" Redistribution and use in source and binary forms, with or without
+
.\" modification, are permitted provided that the following conditions
+
.\" are met:
+
.\" 8. Redistributions of source code must retain the above copyright
+
.\"    notice, this list of conditions and the following disclaimer.
+
.\" 2. Redistributions in binary form must reproduce the above copyright
+
.\"    notice, this list of conditions and the following disclaimer in the
+
.\"    documentation and/or other materials provided with the distribution.
+
.\"
+
.\"
+
.\"     @(#)pkg.1
+
.\" $FreeBSD$
+
.\"
+
.Dd February 24, 2012
+
.Dt PKG 8
+
.Os
+
.\" ---------------------------------------------------------------------------
+
.Sh NAME
+
.Nm pkg
+
.Nd a utility for manipulating packages
+
.\" ---------------------------------------------------------------------------
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl v
+
.Op Fl d
+
.Op Fl j Ao jail name or id Ac | Fl c Ao chroot path Ac
+
.Ao command Ac Ao Ar flags Ac
+
.\" ---------------------------------------------------------------------------
+
.Sh DESCRIPTION
+
provides an interface for manupulating packages - registering,
+
adding, removing and upgrading of packages.
+
.\" ---------------------------------------------------------------------------
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width indent
+
.It Fl v
+
Displays the current version of
+
.Nm
+
.It Fl d
+
Show debug informations
+
.It Fl j Ao jail name or id Ac
+
.Nm
+
will execute in the given
+
.Ao jail name or id Ac
+
.Xr jail 8
+
.It Fl c Ao chroot path Ac
+
.Nm
+
will chroot in the
+
.Ao chroot path Ac
+
Environment
+
.El
+
.\" ---------------------------------------------------------------------------
+
.Sh COMMANDS
+
The following commands are supported by
+
.Nm :
+
.Bl -tag -width indent
+
.It Ic help Ar <command>
+
Display usage information of the specified command.
+
.It Ic add
+
Install a package from either a local source or a remote one.
+
.Pp
+
When installing from remote source you need to specify the
+
protocol to use when fetching the package.
+
.Pp
+
Currently supported protocols are FTP, HTTP and HTTPS.
+
.It Ic audit
+
< To be added >
+
.It Ic autoremove
+
Delete packages which were automatically installed as dependencies and are not
+
required anymore.
+
.It Ic backup
+
Dump the local package database to a file specified on the command-line.
+
.It Ic check
+
< To be added >
+
.It Ic clean
+
< To be added >
+
.It Ic create
+
Create a package
+
.It Ic delete
+
Delete a package from the database and the system.
+
.It Ic info
+
Display information about installed packages.
+
.It Ic install
+
Install a package from a remote package repository.
+
If a package is found in more than one remote repository,
+
then installation happens from the first one. If a package
+
fails to fetch from the remote repository, the next one in
+
the list is tried, until the package is fetched.
+
.It Ic query
+
Query information about installed packages.
+
.It Ic register
+
Register a package in the database.
+
.It Ic repo
+
Create a package repository.
+
.Pp
+
< To be completed >
+
.It Ic search
+
Search for the given pattern in the remote package
+
repositories.
+
.It Ic update
+
Update the available remote repositories as listed in
+
.Xr pkg.conf 5 .
+
.It Ic updating
+
< To be added >
+
.It Ic upgrade
+
Upgrade a package to a newer version.
+
.It Ic version
+
< To be added >
+
.It Ic which
+
Query the database for package(s) that installed a specific
+
file.
+
.El
+
.\" ---------------------------------------------------------------------------
+
.Sh ENVIRONMENT
+
The list of environment variables that affect the execution of
+
.Nm
+
is in
+
.Xr pkg.conf 5 .
+
.\" ---------------------------------------------------------------------------
+
.Sh FILES
+
See
+
.Xr pkg.conf 5 .
+
.\" ---------------------------------------------------------------------------
+
.Sh SEE ALSO
+
.Xr pkg-autoremove 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-query 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xr pkg-update 8 ,
+
.Xr pkg-updating 8 ,
+
.Xr pkg-upgrade 8 ,
+
.Xr pkg-version 8 ,
+
.Xr pkg-which 8 ,
+
.Xr pkg.conf 5
+
.\" ---------------------------------------------------------------------------
+
.Sh HISTORY
+
The
+
.Nm
+
command first appeared in
+
.Fx \" TODO: Put release there
+
.\" ---------------------------------------------------------------------------
+
.Sh AUTHORS AND CONTRIBUTORS
+
.An Baptiste Daroussin Aq bapt@FreeBSD.org
+
.An Julien Laffaye Aq jlaffaye@FreeBSD.org
+
.An Philippe Pepiot Aq phil@philpep.org
+
.An Will Andrews Aq will@FreeBSD.org
+
.An Marin Atanasov Nikolov Aq dnaeon@gmail.com
+
.\" ---------------------------------------------------------------------------
+
.Sh BUGS
+
There might be some left.