Radish alpha
H
rad:z3QDZAW2FAfuLvihrhiyDC9fAD8G9
HardenedBSD Package Manager
Radicle
Git
Merge pull request #187 from bdrewery/manpage-updates
Baptiste Daroussin committed 14 years ago
commit 82752aefbab66cfd2e0ed516387ea1ee6bbbcc84
parent 3676e63
23 files changed +219 -0
modified pkg/Makefile
@@ -51,8 +51,10 @@ LDADD+= -L${.OBJDIR}/../libpkg \
WARNS?=		6
MAN=	pkg.8 \
	pkg-add.8 \
+
	pkg-audit.8 \
	pkg-autoremove.8 \
	pkg-backup.8 \
+
	pkg-check.8 \
	pkg-create.8 \
	pkg-delete.8 \
	pkg-info.8 \
modified pkg/pkg-add.8
@@ -57,11 +57,13 @@ See
.Xr pkg 8 ,
.Xr pkg-create 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xe pkg-set 8 ,
added pkg/pkg-audit.8
@@ -0,0 +1,84 @@
+
.\"
+
.\" 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 April 12, 2012
+
.Dt PKG-AUDIT 8
+
.Os
+
.Sh NAME
+
.Nm "pkg audit"
+
.Nd Audits installed packages against known vulnerabilities.
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl F
+
.Ar <pkg-name>
+
.Sh DESCRIPTION
+
.Nm
+
checks installed packages for known vulnerabilities and generates reports
+
including references to security advisories. Its intended audience is system
+
administrators and individual users.
+
.Pp
+
.Nm
+
uses a database maintained by port committers and the FreeBSD security team
+
to check if security advisories for any installed packages exist.
+
Note that a current ports tree (or any local copy of the ports tree) is not
+
required for operation.
+
.Pp
+
If you have a vulnerable package installed, you are advised to update or
+
deinstall it immediately.
+
.Pp
+
Supplying a
+
.Ar <pkg-name>
+
will audit only that package.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl F
+
Fetch the database before checking.
+
.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-info 8 ,
+
.Xr pkg-check 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xe pkg-set 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 ,
modified pkg/pkg-autoremove.8
@@ -54,12 +54,14 @@ See
.Sh SEE ALSO
.Xr pkg 8 ,
.Xr pkg-add 8 ,
+
.Xr pkg-audit 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-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8 ,
modified pkg/pkg-backup.8
@@ -65,11 +65,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-create 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8 ,
added pkg/pkg-check.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:
+
.\" 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 April 12, 2012
+
.Dt PKG-CHECK 8
+
.Os
+
.Sh NAME
+
.Nm "pkg check"
+
.Nd sanity checks installed packages
+
.Sh SYNOPSIS
+
.Nm
+
.Op Fl yadsr
+
.Nm
+
.Op Fl ygxXdsr
+
.Ar <pattern>
+
.Sh DESCRIPTION
+
.Nm
+
is used to check for and install missing dependencies, find invalid checksums, or recompute sizes of installed packages.
+
.Sh OPTIONS
+
The following options are supported by
+
.Nm :
+
.Bl -tag -width F1
+
.It Fl a
+
Process all packages.
+
.It Fl y
+
Assume yes when asked for confirmation before installing missing dependencies.
+
.It Fl d
+
Check for missing dependencies of matched packages.
+
.It Fl s
+
Show matched packages that do not match the stored checksum.
+
.It Fl r
+
Recomputes the flat size in bytes of the matched packages.
+
.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.
+
.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-audit 8 ,
+
.Xr pkg-search 8 ,
+
.Xr pkg-backup 8 ,
+
.Xr pkg-install 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-delete 8 ,
+
.Xr pkg-create 8 ,
+
.Xr pkg-register 8 ,
+
.Xr pkg-repo 8 ,
+
.Xe pkg-set 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 ,
modified pkg/pkg-create.8
@@ -196,11 +196,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8 ,
modified pkg/pkg-delete.8
@@ -68,11 +68,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-create 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8 ,
modified pkg/pkg-info.8
@@ -119,6 +119,7 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
@@ -126,6 +127,7 @@ See
.Xr pkg-create 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
+
.Xr pkg-check 8 ,
.Xe pkg-set 8 ,
.Xr pkg-update 8 ,
.Xr pkg-updating 8 ,
modified pkg/pkg-install.8
@@ -95,11 +95,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-create 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8,
modified pkg/pkg-query.8
@@ -203,10 +203,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
+
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-create 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
modified pkg/pkg-register.8
@@ -73,11 +73,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-create 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8 ,
modified pkg/pkg-repo.8
@@ -63,11 +63,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-create 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-install 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-search 8 ,
.Xr pkg-set 8 ,
modified pkg/pkg-search.8
@@ -105,11 +105,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-create 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8 ,
modified pkg/pkg-set.8
@@ -56,12 +56,14 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 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-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-update 8 ,
modified pkg/pkg-shlib.8
@@ -54,11 +54,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8 ,
modified pkg/pkg-update.8
@@ -62,11 +62,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8 ,
modified pkg/pkg-updating.8
@@ -78,11 +78,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xe pkg-set 8,
modified pkg/pkg-upgrade.8
@@ -67,11 +67,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8 ,
modified pkg/pkg-version.8
@@ -104,11 +104,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8,
modified pkg/pkg-which.8
@@ -54,11 +54,13 @@ See
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8 ,
modified pkg/pkg.8
@@ -128,12 +128,15 @@ See
.Xr pkg.conf 5 .
.\" ---------------------------------------------------------------------------
.Sh SEE ALSO
+
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-query 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
modified pkg/pkg.conf.5
@@ -111,11 +111,13 @@ file always overrides the value of an option set in the file.
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-autoremove 8 ,
+
.Xr pkg-audit 8 ,
.Xr pkg-search 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-install 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-info 8 ,
+
.Xr pkg-check 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-set 8 ,