DragonFly On-Line Manual Pages

PKG_FETCH(1)           DragonFly 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