PKG_FETCH(1)

NAME
pkg_fetch - a remote package fetcher

SYNOPSIS
pkg_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 followed by an @, or a full URI.

    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 variable 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 downloads 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 ALSO
fetch(1), pkg_add(1), portinstall(1), portupgrade(1), pkgtools.conf(5), ports(7)

AUTHORS
Akinori MUSHA <knu@iDaemons.org>