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

AUTHORS
     Akinori MUSHA <knu@iDaemons.org>

FreeBSD 			August 27, 2001 		       FreeBSD

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