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

FreeBSD Manual Pages

  
 
  

home | help
PKG_FETCH(1)		  BSD 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 in-
			 stalled.  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				 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+12.0-RELEASE+and+Ports>

home | help