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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
PKG_FETCH(1)            FreeBSD General Commands Manual           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, 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
                    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>

FreeBSD                          June 13, 2006                         FreeBSD

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | FILES | SEE ALSO | AUTHORS

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

home | help