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 us-
			   ing	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	speci-
			   fied.

       -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	 pack-
			   ages	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	direc-
		      tory "/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	 pack-
		      ages.  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 configura-
				  tion 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+14.3.quarterly>

home | help