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

FreeBSD Manual Pages

  
 
  

home | help
PKG-UPDATE(8)		    System Manager's Manual		 PKG-UPDATE(8)

NAME
       pkg update -- update the	local catalogues of the	enabled	package	repos-
       itories

SYNOPSIS
       pkg update [-fq]	[-r reponame]

       pkg update [--{force,quiet}] [--repository reponame]

DESCRIPTION
       pkg  update is used for updating	the local copy of the repository cata-
       logues from the remote package repository databases.  Updates to	 cata-
       logues  are normally downloaded only when the master copy on the	remote
       package repository is newer than	the local copy.

       The repository catalogues to be updated are defined in the  pkg.conf(5)
       file  or	 by  the entries in /usr/local/etc/pkg/repos.  See pkg.conf(5)
       for details.

       It is best practice to ensure your package repository catalogues	are up
       to date before doing any	package	installation (via  pkg-install(8))  or
       upgrades	 (via pkg-upgrade(8)).	However, explicitly running pkg	update
       is not normally necessary.  By default invoking either of  pkg  install
       or pkg upgrade will cause repository catalogues to be updated automati-
       cally,	unless	 disabled  by  setting	REPO_AUTOUPDATE	 to  false  in
       pkg.conf(5).

   Signed repositories
       If the repository catalogue is signed and PUBKEY	 is  defined  for  the
       repository,  the	 signature  will  be  verified	after  download.   See
       pkg.conf(5) for more information.

OPTIONS
       The following options are supported by pkg update:

       -q, --quiet
	      Force quiet output.

       -f, --force
	      Force a full download of the repository catalogue	without	regard
	      to the respective	ages of	the local and  remote  copies  of  the
	      catalogue.

       -r reponame, --repository reponame
	      Download the catalogue for the named repository only.  This will
	      update only the named repository,	irrespective of	the configured
	      "enabled"	status from repo.conf.

ENVIRONMENT
       The following environment variables affect the execution	of pkg update.
       See pkg.conf(5) for further description.

       PKG_DBDIR

       REPO_AUTOUPDATE

FILES
       See pkg.conf(5).

SEE ALSO
       pkg_create(3),	 pkg_printf(3),	   pkg_repo_create(3),	 pkg_repos(3),
       pkg-keywords(5),	pkg-lua-script(5),  pkg-repository(5),	pkg-script(5),
       pkg-triggers(5),	  pkg.conf(5),	 pkg(8),   pkg-add(8),	 pkg-alias(8),
       pkg-annotate(8),	  pkg-audit(8),	   pkg-autoremove(8),	 pkg-check(8),
       pkg-clean(8),	  pkg-config(8),     pkg-create(8),	pkg-delete(8),
       pkg-fetch(8),  pkg-info(8),  pkg-install(8),  pkg-key(8),  pkg-lock(8),
       pkg-query(8),	pkg-register(8),   pkg-repo(8),	  pkg-repositories(8),
       pkg-rquery(8), pkg-search(8), pkg-set(8),  pkg-shell(8),	 pkg-shlib(8),
       pkg-ssh(8),     pkg-stats(8),	 pkg-triggers(8),     pkg-updating(8),
       pkg-upgrade(8), pkg-version(8), pkg-which(8)

FreeBSD	14.3			 July 7, 2024			 PKG-UPDATE(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pkg-update&sektion=8&manpath=FreeBSD+14.3-RELEASE+and+Ports>

home | help