PKG_FETCH(1) BSD General Commands Manual PKG_FETCH(1)NAMEpkg_fetch — a remote package fetcher
SYNOPSISpkg_fetch [-hfqRv] pkgname[@] ...
DESCRIPTION
The pkg_fetch command downloads binary packages from remote sites. It
can optionally download packages recursively through dependencies.
OPTIONS
The following command line arguments are supported:
pkgname Specify a full pkgname, a pkgname without version, or
a full URI.
If pkgname is a full package name with version,
pkg_fetch will use “All” directory on a server for
fetching.
If pkgname is a name without version, it will be
fetched from “Latest” directory. You can force using
of “Latest” directory for ambiguous cases adding @ to
the pkgname.
If a full URI is supplied, required packages are also
fetched from the same site when -R is specified.
-h
--help Show help and exit.
-f
--force Download a package even if it is recorded as
installed. By default, pkg_fetch skips the packages
which are recorded as installed.
-q
--noconfig Do not read the configuration file -
$PREFIX/etc/pkgtools.conf.
Remove existing packages if they are corrupt.
-R
--upward-recursive Download the packages required by the given packages
as well.
-v
--verbose Turn on verbose output.
ENVIRONMENT
PACKAGEROOT URI of the root of your preferred mirror site. Default is
“ftp://ftp.FreeBSD.org”. The site must have a directory
“/pub/FreeBSD/ports/$arch/packages-$release/”.
PACKAGESITE URI of the directory to fetch packages from. This vari‐
able precedes all other package site related variables,
i.e. PACKAGEROOT and PKG_SITES. Use of this variable is
discouraged. Use PKG_SITES.
PKG_SITES List of URI's to fetch packages from separated by space.
Each site directory must contain directories named “All”
and “Latest”.
PACKAGES Base directory where pkg_fetch saves downloaded packages.
Default is “$PORTSDIR/packages”.
PKG_DBDIR Alternative location for the installed package database.
Default is “/var/db/pkg”.
PKG_FETCH Alternative command for downloading files. Default is
“/usr/bin/fetch -ao '%2$s' '%1$s'”, where every actual
command line is composed as:
sprintf(PKG_FETCH, URI, path)
For example, try “wget -O '%2$s' '%1$s'” or “curl '%s' -o
'%s'”.
PKG_TMPDIR
TMPDIR (In that order) Temporary directory where pkg_fetch down‐
loads files temporarily. If neither is not defined,
“/var/tmp” is used.
PORTSDIR Alternative location for the ports tree. Default is
“/usr/ports”.
PKGTOOLS_CONF Configuration file for the pkgtools suite. Default is
“$PREFIX/etc/pkgtools.conf”.
FILES
/usr/ports Default location of the ports tree
/usr/ports/packages/All Default location to save downloaded files
into.
/var/tmp Default location to save downloaded files into
temporarily.
$PREFIX/etc/pkgtools.conf Default location of the pkgtools configuration
file.
SEE ALSOfetch(1), pkg_add(1), portinstall(1), portupgrade(1), pkgtools.conf(5),
ports(7)AUTHORS
Akinori MUSHA ⟨knu@iDaemons.org⟩
FreeBSD June 13, 2006 FreeBSD
