From: Ben Gras Date: Sun, 18 Jul 2010 22:15:10 +0000 (+0000) Subject: man: add some pkgsrc pages; no more minix diff manpage X-Git-Tag: v3.1.8~204 X-Git-Url: http://zhaoyanbai.com/repos/%22http:/www.isc.org/icons/CHANGES?a=commitdiff_plain;h=dc2194efa79759c0fc9a1b1f032b278b23be3bb7;p=minix.git man: add some pkgsrc pages; no more minix diff manpage --- diff --git a/man/man1/Makefile b/man/man1/Makefile index e060ff7d4..e10d3b5d5 100644 --- a/man/man1/Makefile +++ b/man/man1/Makefile @@ -1,9 +1,9 @@ MAN= acd.1 anm.1 ar.1 ash.1 asize.1 at.1 banner.1 basename.1 \ bsfilt.1 cal.1 \ - calendar.1 cat.1 cawf.1 cc.1 cdiff.1 chgrp.1 \ + calendar.1 cat.1 cawf.1 cc.1 chgrp.1 \ chmem.1 chmod.1 cksum.1 clear.1 cmp.1 comm.1 compress.1 \ cp.1 crc.1 crontab.1 ctags.1 dd.1 dev2name.1 \ - df.1 dhrystone.1 diff.1 dosdir.1 dosread.1 doswrite.1 du.1 \ + df.1 dhrystone.1 dosdir.1 dosread.1 doswrite.1 du.1 \ dumpcore.1 easypack.1 echo.1 ed.1 eject.1 elvis.1 elvrec.1 \ env.1 expand.1 expr.1 factor.1 file.1 \ finger.1 flexdoc.1 fmt.1 fold.1 format.1 fortune.1 \ @@ -23,7 +23,8 @@ MAN= acd.1 anm.1 ar.1 ash.1 asize.1 at.1 banner.1 basename.1 \ term.1 termcap.1 tget.1 time.1 top.1 tr.1 true.1 \ truncate.1 tsort.1 tty.1 umount.1 uname.1 unexpand.1 uniq.1 \ urlget.1 uud.1 uue.1 vol.1 wc.1 whereis.1 which.1 \ - who.1 whoami.1 write.1 xargs.1 yap.1 yes.1 + who.1 whoami.1 write.1 xargs.1 yap.1 yes.1 linkfarm.1 pkg_view.1 + .include .include diff --git a/man/man1/diff.1 b/man/man1/diff.1 deleted file mode 100644 index 3fe3dccb4..000000000 --- a/man/man1/diff.1 +++ /dev/null @@ -1,47 +0,0 @@ -.TH DIFF 1 -.SH NAME -diff \- print differences between two files -.SH SYNOPSIS -\fBdiff \fR [\fB\-c \fR|\fB \-e \fR|\fB \-C \fIn\fR\] [\fB\-br\fR]\fIfile1 file2\fR\fR -.br -.de FL -.TP -\\fB\\$1\\fR -\\$2 -.. -.de EX -.TP 20 -\\fB\\$1\\fR -# \\$2 -.. -.SH OPTIONS -.FL "\-C \fIn" "Produce output that contains \fIn\fR lines of context" -.FL "\-b" "Ignore white space when comparing" -.FL "\-c" "Produce output that contains three lines of context" -.FL "\-e" "Produce an \fIed\fR-script to convert \fIfile1\fR into \fIfile2\fR" -.FL "\-r" "Apply \fIdiff\fR recursively to files and directories of the same name, when \fIfile1\fR and \fIfile2\fR are both directories" -.SH EXAMPLES -.EX "diff file1 file2" "Print differences between 2 files" -.EX "diff -C 0 file1 file2" "Same as above" -.EX "diff -C 3 file1 file2" "Output three lines of context with every difference encountered" -.EX "diff -c file1 file2" Same as above" -.EX "diff /etc /dev" "Compares recursively the directories \fI/etc\fR and \fI/dev\fR" -.EX "diff passwd /etc" "Compares \fI./passwd\fR to \fI/etc/passwd" -.SH DESCRIPTION -.PP -\fIDiff\fR compares two files and generates a list of lines telling how -the two files differ. Lines may not be longer than 128 characters. -If the two arguments on the command line are both directories, -\fIdiff\fR recursively steps through all subdirectories comparing -files of the same name. If a file name is found only in one directory, -a diagnostic message is written to \fIstdout\fR. A file that is of -either block special, character special or FIFO special type, cannot -be compared to any other file. -On the other hand, if there is one directory and one file given on the -command line, \fIdiff\fR tries to compare the file with the same name -as \fIfile\fR in the directory \fIdirectory\fR. -.SH "SEE ALSO" -.BR cdiff (1), -.BR cmp (1), -.BR comm (1), -.BR patch (1). diff --git a/man/man1/linkfarm.1 b/man/man1/linkfarm.1 new file mode 100644 index 000000000..a219670bd --- /dev/null +++ b/man/man1/linkfarm.1 @@ -0,0 +1,148 @@ +.\" $NetBSD: linkfarm.1,v 1.6 2009/02/08 23:11:56 wiz Exp $ +.\" +.\" Copyright (c) 2003 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" 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. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the NetBSD +.\" Foundation, Inc. and its contributors. +.\" 4. Neither the name of The NetBSD Foundation nor the names of its +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.Dd September 2, 2003 +.Dt LINKFARM 1 +.Os +.Sh NAME +.Nm linkfarm +.Nd manage symbolic links to package files +.Sh SYNOPSIS +.Nm +.Op Fl cDnRVv +.Op Fl d Ar stowdir +.Op Fl s Ar subdir +.Op Fl t Ar target +.Ar package +.Sh DESCRIPTION +The +.Nm +command is used to manage a "linkfarm", a directory tree of symbolic links in +.Ar target +to the files in the +.Ar package +sub-directory of +.Ar stowdir . +The default action is to create a linkfarm to a package. +.Pp +The following command-line options are supported: +.Bl -tag -width indent +.It Fl c +Check whether a package contains a linkfarm in +.Ar target . +If +.Ar package +has no symbolic links in +.Ar target +that correspond to its files, then return 0, otherwise return 1. +.It Fl D +Delete the linkfarm for +.Ar package . +.It Fl d Ar stowdir +Set +.Ar stowdir +as the directory in which +.Ar package +can be found. +The default +.Ar stowdir +is the +.Pa packages +sub-directory in the default +.Ar target +directory. +.It Fl n +Don't actually execute the commands for removing and creating the symbolic +links and directories. +.It Fl R +Delete and re-create the linkfarm for +.Ar package . +.It Fl s Ar subdir +The root of the package hierarchy for the linkfarm is the +.Ar subdir +sub-directory in the package. +By default, assume the root of the package hierarchy is simply the +.Ar package +directory. +.It Fl t Ar target +Set +.Ar target +as the directory in which to create and delete the linkfarm for +.Ar package . +The default +.Ar target +directory is +.Pa /usr/pkg +but may be overridden by the +.Ev LOCALBASE +environment variable. +.It Fl V +Print version number and exit. +.It Fl v +Turn on verbose output. +Specifying +.Fl v +multiple times increases the level of verbosity. +.El +.Sh ENVIRONMENT +.Bl -tag -width indent +.It Ev LOCALBASE +The standard packages directory, +.Pa /usr/pkg , +can be overridden by specifying an alternative directory in the +.Ev LOCALBASE +environment variable. +This affects the default +.Ar target +and +.Ar stowdir +directories. +.It Ev PLIST_IGNORE_FILES +This can be used to specify files in +.Ar package +that should ignored when creating and deleting symbolic links in +.Ar target . +.Ev PLIST_IGNORE_FILES +is a space-separated list of shell glob patterns that match files relative +to the +.Ar package +directory, and it defaults to "info/dir *[~#] *.OLD *.orig *,v". +.El +.Sh SEE ALSO +.Xr lndir 1 , +.Xr pkg_view 1 +.Sh AUTHORS +The +.Nm +utility was written by +.An Alistair G. Crooks Aq agc@NetBSD.org . diff --git a/man/man1/pkg_view.1 b/man/man1/pkg_view.1 new file mode 100644 index 000000000..376dd79a1 --- /dev/null +++ b/man/man1/pkg_view.1 @@ -0,0 +1,276 @@ +.\" $NetBSD: pkg_view.1,v 1.13 2010/01/22 13:30:42 joerg Exp $ +.\" +.\" Copyright (c) 2003 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" 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. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the NetBSD +.\" Foundation, Inc. and its contributors. +.\" 4. Neither the name of The NetBSD Foundation nor the names of its +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.Dd September 8, 2003 +.Dt PKG_VIEW 1 +.Os +.Sh NAME +.Nm pkg_view +.Nd add and delete instances of depoted packages in views +.Sh SYNOPSIS +.Nm +.Op Fl nVv +.Op Fl d Ar stowdir +.Op Fl i Ar ignore +.Op Fl k Ar pkg_dbdir +.Op Fl W Ar viewbase +.Op Fl w Ar view +.Ar command +.Ar package ... +.Sh DESCRIPTION +The +.Nm +command is used to add and delete instances of depoted packages in +.Ar stowdir +in a +.Ar view +in the +.Ar viewbase +directory. +.Sh WARNING +.Bf -emphasis +Since the +.Nm +command may execute scripts or programs provided by a package file, +your system may be susceptible to +.Dq Trojan horses +or other subtle +attacks from miscreants who create dangerous package files. +.Pp +You are advised to verify the competence and identity of those who +provide installable package files. +For extra protection, examine all the package control files in the +package database directory +.Pa ( /usr/pkg/packages/\*[Lt]pkg-name\*[Gt]/ ) . +Pay particular attention to any +.Pa +INSTALL +or +.Pa +DEINSTALL +files, and inspect the +.Pa +CONTENTS +file for +.Cm @cwd , +.Cm @mode +(check for setuid), +.Cm @dirrm , +.Cm @exec , +and +.Cm @unexec +directives, and/or use the +.Xr pkg_info 1 +command to examine the installed package control files. +.Ef +.Sh OPTIONS +The following command-line options are supported: +.Bl -tag -width indent +.It Fl d Ar stowdir +Set +.Ar stowdir +as the directory in which the depoted packages can be found. +If this option isn't specified, then the +.Ar stowdir +is taken from the value of the environment variable +.Ev DEPOTBASE +if it's set, otherwise the default +.Ar stowdir +is the path to the +.Pa packages +directory under +.Ar viewbase . +.It Fl i Ar ignore +Add +.Ar ignore +to the list of files in +.Ar package +that should ignored when adding or removing the package instance from +.Ar view . +.It Fl k Ar pkg_dbdir +Override the value of the +.Dv PKG_DBDIR +configuration option with the value +.Ar pkg_dbdir . +This is used as as the package database directory for the +default (empty) view. +.It Fl n +Don't actually execute the commands for manipulating the package instances. +.It Fl V +Print the version number and exit. +.It Fl v +Turn on verbose output. +Specifying +.Fl v +multiple times increases the level of verbosity. +.It Fl W Ar viewbase +Set +.Ar viewbase +as the directory in which all the views are managed. +The default +.Ar viewbase +directory is +.Pa /usr/pkg +but may be overridden by the +.Ev LOCALBASE +environment variable. +.It Fl w Ar view +Set +.Ar view +as the directory in +.Ar viewbase +in which the package instances should be added or deleted. +The default +.Ar view +is the empty view but may be overridden by the +.Ev PKG_VIEW +environment variable. +.El +.Pp +The following commands are supported: +.Bl -tag -width indent +.It Cm add +Add the listed package instances into +.Ar view . +.It Cm check +Check whether the listed package instances are present in +.Ar view . +If they are not present, then return 0, otherwise return 1. +.It Cm delete +Delete the listed package instances from +.Ar view . +.El +.Sh ENVIRONMENT +.Bl -tag -width indent +.It Ev DEPOTBASE +This is the location of the +.Ar stowdir +directory inside which all depoted packages are kept. +The default +.Ar stowdir +is the +.Pa packages +directory under +.Ar viewbase . +.It Ev LOCALBASE +This is the location of the +.Ar viewbase +directory in which all the views are managed. +The default +.Ar viewbase +directory is +.Pa /usr/pkg . +.It Ev PKG_DBDIR +If the +.Fl k +flag isn't given, then the value of the environment variable +.Ev PKG_DBDIR +is the package database directory for the default view, +otherwise it defaults to +.Pa /var/db/pkg . +.It Ev PLIST_IGNORE_FILES +This can be used to specify files in +.Ar package +that should ignored when adding or removing the package instance from +.Ar view . +.Ev PLIST_IGNORE_FILES +is a space-separated list of shell glob patterns that match files relative +to the +.Ar package +depot directory, and it defaults to "info/dir *[~#] *.OLD *.orig *,v". +This is overridden by any +.Ev _PLIST_IGNORE_FILES +setting in a package's +.Ar build-info-file +(see +.Xr pkg_create 1 ) +if it exists. +.It Ev PKG_VIEW +The default view can be specified in the +.Ev PKG_VIEW +environment variable. +.El +.Sh FILES +.Bl -tag -width indent +.It Pa \*[Lt]pkg-dbdir\*[Gt]/\*[Lt]package\*[Gt]/+INSTALL +If the package contains an +.Ar install +script (see +.Xr pkg_create 1 ) , +then after the package instance is added into a view, the script is +executed with the following arguments: +.Bl -tag -width package +.It Ar package +The name of the package instance being added. +.It Cm VIEW-INSTALL +Keyword denoting that the script is to perform any actions needed after +the package instance is added to a view. +.El +.Pp +If the +.Ar install +script exits with a non-zero status code, the installation is terminated. +.It Pa \*[Lt]pkg-dbdir\*[Gt]/\*[Lt]package\*[Gt]/+DEINSTALL +If the package contains an +.Ar deinstall +script (see +.Xr pkg_create 1 ) , +then before the package instance is deleted from a view, the script is +executed with the following arguments: +.Bl -tag -width package +.It Ar package +The name of the package instance being deleted. +.It Cm VIEW-DEINSTALL +Keyword denoting that the script is to perform any actions needed before +the package instance is deleted from a view. +.El +.Pp +If the +.Ar deinstall +script exits with a non-zero status code, the de-installation is terminated. +.El +.Pp +The +.Ar install +and +.Ar deinstall +scripts are called with the environment variable +.Ev PKG_PREFIX +set to the path to the +.Ar view +directory. +.Sh SEE ALSO +.Xr linkfarm 1 , +.Xr pkg_delete 1 +.Sh AUTHORS +The +.Nm +utility was written by +.An Alistair G. Crooks Aq agc@NetBSD.org . diff --git a/man/man5/Makefile b/man/man5/Makefile index ff54a635b..4bd5f51b6 100644 --- a/man/man5/Makefile +++ b/man/man5/Makefile @@ -2,7 +2,7 @@ MAN= configfile.5 crontab.5 dhcp.conf.5 dir.5 ethers.5 \ fstab.5 hosts.5 httpd.conf.5 http_status.5 keymap.5 \ passwd.5 resolv.conf.5 resolver.5 rhosts.5 statvfs.5 serv.access.5 \ system.conf.5 syslog.conf.5 termcap.5 ttytab.5 TZ.5 tzfile.5 utmp.5 \ - whatis.5 + whatis.5 pkg_install.conf.5 pkg_summary.5 .include .include diff --git a/man/man5/pkg_install.conf.5 b/man/man5/pkg_install.conf.5 new file mode 100644 index 000000000..5cc6b5719 --- /dev/null +++ b/man/man5/pkg_install.conf.5 @@ -0,0 +1,215 @@ +.\" $NetBSD: pkg_install.conf.5.in,v 1.14 2010/06/16 23:02:49 joerg Exp $ +.\" +.\" Copyright (c) 2008, 2009 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Thomas Klausner. +.\" +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.Dd June 16, 2010 +.Dt PKG_INSTALL.CONF 5 +.Os +.Sh NAME +.Nm pkg_install.conf +.Nd configuration file for package installation tools +.Sh DESCRIPTION +The file +.Nm +contains system defaults for the package installation tools +as a list of variable-value pairs. +Each line has the format +.Ev VARIABLE=VALUE . +If the value consists of more than one line, each line is prefixed with +.Ev VARIABLE= . +.Pp +The current value of a variable can be checked by running +.Dl Ic pkg_admin config-var VARIABLE +.Pp +Some variables are overriden by environmental variables of the same name. +Those are marked by (*). +.Pp +The following variables are supported: +.Bl -tag -width indent +.It Dv ACCEPTABLE_LICENSES +List of licenses packages are allowed to carry. +License names are case-sensitive. +.It Dv ACTIVE_FTP +Force the use of active FTP. +.It Dv CACHE_INDEX +Cache directory listenings in memory. +This avoids retransfers of the large directory index for HTTP and is +enabled by default. +.It Dv CERTIFICATE_ANCHOR_PKGS +Path to the file containing the certificates used for validating +binary packages. +A package is trusted when a certificate chain ends in one of the +certificates contained in this file. +The certificates must be PEM-encoded. +.It Dv CERTIFICATE_ANCHOR_PKGVULN +Analogous to +.Dv CERTIFICATE_ANCHOR_PKGS . +The +.Pa pkg-vulnerabilities +is trusted when a certificate chain ends in one of the certificates +contained in this file. +.It Dv CERTIFICATE_CHAIN +Path to a file containing additional certificates that can be used +for completing certificate chains when validating binary packages or +pkg-vulnerabilities files. +.It Dv CHECK_LICENSE +Check the license conditions of packages before installing them. +Supported values are: +.Bl -tag -width interactiveXX +.It Dv no +The check is not performed. +.It Dv yes +The check is performed if the package has license conditions set. +.It Dv always +Passing the license check is required. +Missing license conditions are considered an error. +.El +.It Dv CHECK_END_OF_FILE +During vulnerability checks, consider packages that have reached end-of-life +as vulnerable. +This option is enabled by default. +.It Dv CHECK_VULNERABILITIES +Check for vulnerabilities when installing packages. +Supported values are: +.Bl -tag -width interactiveXX +.It Dv never +No check is performed. +.It Dv always +Passing the vulnerability check is required. +A missing pkg-vulnerabilities file is considered an error. +.It Dv interactive +The user is always asked to confirm installation of vulnerable packages. +.El +.It Dv CONFIG_CACHE_CONNECTIONS +Limit the global connection cache to this value. +For FTP this is the number of sessions without active command. +For HTTP this is the number of connections open with keep-alive. +.It Dv CONFIG_CACHE_CONNECTIONS_HOST +Like +.Dv CONFIG_CACHE_CONNECTIONS , +but limit the number of connections to the host as well. +See +.Xr fetch 3 +for further details +.It Dv DEFAULT_ACCEPTABLE_LICENSES +List of common Free and Open Source licenses packages are allowed to carry. +The default value contains all OSI approved licenses in pkgsrc on the date +pkg_install was released. +License names are case-sensitive. +.It Dv GPG +Path to +.Xr gpg 1 , +which can be used to verify the signature in the +.Pa pkg-vulnerabilities +file when running +.Dl Ic pkg_admin check-pkg-vulnerabilities -s +or +.Dl Ic pkg_admin fetch-pkg-vulnerabilities -s +It can also be used to verify and sign binary packages. +.It Dv GPG_KEYRING_PKGVULN +Non-default keyring to use for verifying GPG signatures of +.Pa pkg-vulnerabilities . +.It Dv GPG_KEYRING_SIGN +Non-default keyring to use for signing packages with GPG. +.It Dv GPG_KEYRING_VERIFY +Non-default keyring to use for verifying GPG signature of packages. +.It Dv GPG_SIGN_AS +User-id to use for signing packages. +.It Dv IGNORE_PROXY +Use direct connections and ignore +.Ev FTP_PROXY +and +.Ev HTTP_PROXY . +.It Dv IGNORE_URL +One line per advisory which should be ignored when running +.Dl Ic pkg_admin audit +The URL from the +.Pa pkg-vulnerabilities +file should be used as value. +.It Dv PKG_DBDIR (*) +Location of the packages database. +This option is always overriden by the argument of the +.Fl K +option. +.It Dv PKG_PATH (*) +Search path for packages. +The entries are separated by semicolon. +Each entry specifies a directory or URL to search for packages. +.It Dv PKG_REFCOUNT_DBDIR (*) +Location of the package reference counts database directory. +The default value is +.Pa ${PKG_DBDIR}.refcount . +.It Dv PKGVULNDIR +Directory name in which the +.Pa pkg-vulnerabilities +file resides. +Default is +.Pa ${PKG_DBDIR} . +.It Dv PKGVULNURL +URL which is used for updating the local +.Pa pkg-vulnerabilities +file when running +.Dl Ic pkg_admin fetch-pkg-vulnerabilities +The default location is ftp.NetBSD.org using HTTP. +.Em Note : +Usually, only the compression type should be changed. +Currently supported are uncompressed files and files compressed by +.Xr bzip2 1 +.Pq Pa .bz2 +or +.Xr gzip 1 +.Pq Pa .gz . +.It Dv VERBOSE_NETIO +Log details of network IO to stderr. +.It Dv VERIFIED_INSTALLATION +Set trust level used when installation. +Supported values are: +.Bl -tag -width interactiveXX +.It Dv never +No signature checks are performed. +.It Dv always +A valid signature is required. +If the binary package can not be verified, the installation is terminated +.It Dv trusted +A valid signature is required. +If the binary package can not be verified, the user is asked interactively. +.It Dv interactive +The user is always asked interactively when installing a package. +.El +.El +.Sh FILES +.Bl -tag -width ".Pa /etc/pkg_install.conf" +.It Pa /etc/pkg_install.conf +Default location for the file described in this manual page. +.El +.Sh SEE ALSO +.Xr pkg_add 1 , +.Xr pkg_admin 1 +.Xr pkg_create 1 , +.Xr pkg_delete 1 , +.Xr pkg_info 1 diff --git a/man/man5/pkg_summary.5 b/man/man5/pkg_summary.5 new file mode 100644 index 000000000..08aece1c2 --- /dev/null +++ b/man/man5/pkg_summary.5 @@ -0,0 +1,133 @@ +.\" $NetBSD: pkg_summary.5,v 1.9 2009/05/02 16:14:37 reed Exp $ +.\" +.\" Copyright (c) 2006 The NetBSD Foundation +.\" +.\" 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. +.\" 3. Neither the name of the NetBSD Foundation nor the names of its +.\" contributors may be used to endorse or promote products derived from +.\" this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION AND ITS CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT +.\" NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND +.\" FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT +.\" SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, +.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.Dd April 11, 2009 +.Dt PKG_SUMMARY 5 +.Os +.Sh NAME +.Nm pkg_summary +.Nd summary of binary package repository +.Sh DESCRIPTION +The file +.Nm +contains information about each package in a binary package +repository as a list of variable-value pairs. +The variables describing different packages are separated by one empty +line. +Each line has the format +.Ev VARIABLE=VALUE . +If the value consists of more than one line, each line is prefixed with +.Ev VARIABLE= . +Multi-line variables are guaranteed to be in consecutive lines. +.Pp +The following variables are used: +.Bl -tag -width indent +.It Ev BUILD_DATE +(required) The date and time when the package was built. +.It Ev CATEGORIES +(required) A list of categories which this package fits in, separated by +space. +.It Ev COMMENT +(required) A one-line description of the package. +.It Ev CONFLICTS +(optional) A list of dewey patterns of packages the package conflicts +with, one per line. +If missing, this package has no conflicts. +.It Ev DEPENDS +(optional) A list of dewey patterns of packages the package depends +on, one per line. +If missing, this package has no dependencies. +.It Ev DESCRIPTION +(required) A more detailed description of the package. +.\" DIGEST +.It Ev FILE_NAME +(optional) The name of the binary package file. +If not given, +.Pa PKGNAME.tgz +can be assumed. +.It Ev FILE_SIZE +(optional) The size of the binary package file, in bytes. +.It Ev HOMEPAGE +(optional) A URL where more information about the package can be found. +.It Ev LICENSE +(optional) The type of license this package is distributed under. +If empty or missing, it is OSI-approved. +.It Ev MACHINE_ARCH +(required) The architecture on which the package was compiled. +.It Ev OPSYS +(required) The operating system on which the package was compiled. +.It Ev OS_VERSION +(required) The version of the operating system on which the package +was compiled. +.It Ev PKG_OPTIONS +(optional) Any options selected to compile this package. +If missing, the package does not support options. +.It Ev PKGNAME +(required) The name of the package. +.It Ev PKGPATH +(required) The path of the package directory within pkgsrc. +.It Ev PKGTOOLS_VERSION +(required) The version of the package tools used to create the package. +.It Ev PREV_PKGPATH +(optional) The previous path of the package directory within pkgsrc when +a package was moved. +(See +.Ev SUPERSEDES +below for a renamed package.) +.It Ev PROVIDES +(optional) A list of shared libraries provided by the package, +including major version number, one per line. +If missing, this package does not provide shared libraries. +.It Ev REQUIRES +(optional) A list of shared libraries needed by the package, including +major version number, one per line. +If missing, this package does not require shared libraries. +.It Ev SIZE_PKG +(required) The size of the package when installed, in bytes. +.It Ev SUPERSEDES +(optional) A list of dewey patterns of previous packages this +package replaces, one per line. +This is used for package renaming. +.El +.Pp +The +.Nm pkg_summary +file can be generated using the +.Xr pkg_info 1 +.Fl X +option. +For example, the following will list this data for all installed packages: +.Pp +.Dl "pkg_info -X -a" +.Sh SEE ALSO +.Xr pkg_info 1 +.Sh HISTORY +The +.Nm pkg_summary +format was first officially documented in April 2006. diff --git a/man/man7/Makefile b/man/man7/Makefile index 8c5e3ddee..3658228a1 100644 --- a/man/man7/Makefile +++ b/man/man7/Makefile @@ -4,7 +4,8 @@ MAN= ACK.7 ascii.7 environ.7 hier.7 man.7 oss_atiaudio.7 \ oss_emu10k1x.7 oss_envy24.7 oss_envy24ht.7 oss_fmedia.7 \ oss_geode.7 oss_hdaudio.7 oss_ich.7 oss_sblive.7 \ oss_sbpci.7 oss_sbxfi.7 oss_solo.7 oss_trident.7 \ - oss_via823x.7 oss_via97.7 oss_ymf7xx.7 re_format.7 + oss_via823x.7 oss_via97.7 oss_ymf7xx.7 re_format.7 \ + pkgsrc.7 .include .include diff --git a/man/man7/pkgsrc.7 b/man/man7/pkgsrc.7 new file mode 100644 index 000000000..86d3408b7 --- /dev/null +++ b/man/man7/pkgsrc.7 @@ -0,0 +1,54 @@ +.\" $NetBSD: pkgsrc.7,v 1.2 2007/10/07 12:59:14 kano Exp $ +.\" +.\" Copyright (c) 2007 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Thomas Klausner. +.\" +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.Dd March 2, 2007 +.Dt PKGSRC 7 +.Os +.Sh NAME +.Nm pkgsrc +.Nd NetBSD packages collection (framework for third-party software) +.Sh DESCRIPTION +The +.Nx +Packages Collection (pkgsrc) is a framework for building and +maintaining third-party software on +.Nx +and other +.Ux Ns -like +systems. +It is used to enable freely available software to be configured +and built easily on supported platforms. +.Pp +Tools are available to install ready-to-use packages and to perform +various administrative tasks for the package system. +.Sh SEE ALSO +.Xr pkg_add 1 , +.Xr pkg_delete 1 , +.Xr pkg_info 1 , +.Pa http://www.netbsd.org/docs/pkgsrc/