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 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

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

home | help