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

FreeBSD Manual Pages

  
 
  

home | help
PKG_FETCH(1)		     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 discour-
		    aged.  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  com-
		    mand 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 		    PKG_FETCH(1)

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

home | help