Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PKG_VALIDATE(1)		FreeBSD	General	Commands Manual	       PKG_VALIDATE(1)

NAME
     pkg_validate -- list mismatched and missing files of installed packages

SYNOPSIS
     pkg_validate [-cDmoqv] [-j	jobs] [-a]
     pkg_validate [-CcdDgimOoqrvx] [-j jobs] pkg-name ...
     pkg_validate -h

DESCRIPTION
     The pkg_validate script provides the same functionality as	running	`pkg
     check -s'.	 It can	be run by an unprivileged user and its use of multiple
     processes can make	it significantly faster	when files are cached in mem-
     ory or read from a	fast solid state drive.

OPTIONS
     The following options are available:

     -a	--all
	     Check all packages. This is the default action in case no
	     pkg-name has been specified.

     -C	--case-sensitive
	     See pkg-info(8).

     -c	--clean
	     Create clean output without status	messages.

     -d	--dependencies
	     Also operate on the dependencies of the provided pkg-name.

     -D	--developer
	     Produce additional	output relevant	to ports(7) and	pkg(8)
	     developers.

	     Currently it provides information about dead symlinks.

     -g	--glob
	     See pkg-info(8).

     -h	--help
	     Displays the available options.

     -i	--case-insensitive
	     See pkg-info(8).

     -j	jobs --jobs jobs
	     Specify the amount	of parallel jobs the script will attempt run.
	     The default is number of detected cores plus one.

     -m	--no-filter
	     In	this mode files	that cannot be checked due to user permissions
	     are listed	along with checksum mismatches and missing files.

     -O	--by-origin
	     See pkg-info(8).

     -o	--origin
	     Instead of	the package name the package origin is printed.

     -q	--quiet
	     Only print	the names of affected packages.	Do not print any de-
	     tails. This option	is meant for machine readability.

	     This option cannot	be combined with verbose output.

     -r	--required-by
	     Also check	packages that depend on	the provided packages.	This
	     is	a good idea when checking for the effects of a library update.

     -v	--verbose
	     List the selected packages	before checking	them.

     -x	--regex
	     See pkg-info(8).

     pkg-name
	     Packages are package names	or shell glob patterns matching	these.
	     Whatever works with pkg-info(8) is	an acceptable package.

EXAMPLES
     To	check all your packages	run:

	   pkg_validate

     List files	that cannot be checked due to missing user privileges:

	   pkg_validate	-m

     Produce output suitable as	input to other pkg(8) tools:

	   pkg_validate	-q

     For operating poudriere(8)	or portmaster(8) it can	be more	useful to out-
     put package origins instead of names:

	   pkg_validate	-o

     Flags can be combined:

	   pkg_validate	-qo

ENVIRONMENT
     The following environment variables affect	the operation of pkg_validate.

     DEVELOPER
	     Activates additional diagnostics, see the --developer option.

	     Set to `yes' or 1 to enable. This is equivalent to	the DEVELOPER
	     macro of <bsd.port.mk>.

EXIT STATUS
     1	     The script	has terminated because it received SIGHUP, SIGINT or
	     SIGTERM.

     2	     An	unknown	parameter has been supplied.

     3	     The incompatible parameters -v and	-q have	been supplied.

     4	     The parameter -j has been supplied	without	an acceptable number.

SEE ALSO
     pkg-check(8), pkg-query(8), pkg-info(8), sha256(1), readlink(1)

HISTORY
     A pkg_validate script first appeared in the bsdadminscripts-3.0 collec-
     tion. It was deemed obsolete with the inception of	bsda2 and rewritten
     for bsda2-0.3.0.

AUTHORS
     Dominic Fandrey <freebsd@k4m1.org>

FreeBSD	13.0		       23 February, 2021		  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | ENVIRONMENT | EXIT STATUS | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pkg_validate&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help