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

FreeBSD Manual Pages

  
 
  

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

NAME
       pkg add -- Registers a package and installs it on the system

SYNOPSIS
       pkg add [-IAfMq]	pkg-name ...
       pkg add [-IAfMq]	<protocol>://<path>/<pkg-name> ...

       pkg	add	 [--{no-scripts,automatic,force,accept-missing,quiet}]
	   [--relocate location] pkg-name ...
       pkg	add	 [--{no-scripts,automatic,force,accept-missing,quiet}]
	   [--relocate location] <protocol>://<path>/<pkg-name>	...

DESCRIPTION
       pkg add installs	packages from either a local source or a remote	one.

       When  installing	 from a	remote source you need to specify the protocol
       to use when fetching the	package.

       Currently supported protocols are FTP, HTTP and HTTPS.

       Otherwise, pkg add will read the	file named on the command line.

       If this is a regular file, and the package to be	 installed  has	 unmet
       dependencies, pkg add will search the directory containing pkg-name for
       suitable	 pkg archive files to fulfill those dependencies.  If pkg-name
       is literally - then it will read	the package data from stdin.  pkg  add
       will  automatically  detect  and	unpack most common compression formats
       based on	the content of the data	stream it reads, ignoring  any	exten-
       sion the	filename may have.

       If this involves	reading	from a pipe (including stdin), fifo, socket or
       some  other  non-regular	form of	input stream then pkg add will immedi-
       ately emit an error if pkg-name has unmet dependencies.

OPTIONS
       The following options are supported by pkg add:

       -A, --automatic
		  Mark the installed packages as automatic.  Will be automati-
		  cally	removed	if no other packages depend on them.  For more
		  information please refer to pkg-autoremove(8).

       -f, --force
		  Force	the reinstallation  of	the  package  if  already  in-
		  stalled.

       -I, --no-scripts
		  If  any  installation	 scripts (pre-install or post-install)
		  exist	for given packages, do not execute them.

       -M, --accept-missing
		  Force	the installation of the	package	with missing dependen-
		  cies.

       -q, --quiet
		  Force	quiet output.

       --script-no-exec
		  Do not execute the pre-install and post-install scripts  but
		  still	 log  the  scripts  in the package database for	future
		  reference.  Unlike -I, which prevents	scripts	from both run-
		  ning and being recorded,  --script-no-exec  only  suppresses
		  execution.

       --relocate location
		  Annotates  the package as having been	relocated to location,
		  which	is an alternate	system root.  This is an  experimental
		  feature  and intended	for cross-architecture package manage-
		  ment.	 There	is  no	corresponding  single  letter  option.
		  (DEPRECATED)

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

       DEFAULT_ALWAYS_YES

       ASSUME_ALWAYS_YES

       HANDLE_RC_SCRIPTS

       PKG_DBDIR

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-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-help(8),
       pkg-info(8), pkg-install(8), pkg-key(8),	 pkg-lock(8),  pkg-plugins(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-unregister(8),
       pkg-update(8),	pkg-updating(8),    pkg-upgrade(8),    pkg-version(8),
       pkg-which(8)

FreeBSD	ports 15.quarterly	 May 25, 2014			    PKG-ADD(8)

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

home | help