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 depen-
     dencies, 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 automati-
     cally detect and unpack most common compression formats based on  the  con-
     tent  of  the data stream it reads, ignoring any extension 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 immediately
     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 automatically
		removed if no other packages depend on them.  For more	informa-
		tion please refer to pkg-autoremove(8).

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

     -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 dependencies.

     -q, --quiet
		Force quiet output.

     --relocate location
		Annotates the package as  having  been	relocated  to  location,
		which is an alternate system root.  This is an experimental fea-
		ture  and  intended  for  cross-architecture package management.
		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_printf(3),  pkg_repos(3),  pkg-lua-script(5),	pkg-repository(5),  pkg-
     script(5),  pkg.conf(5),  pkg(8),	pkg-alias(8),  pkg-annotate(8),  pkg-au-
     dit(8),  pkg-autoremove(8), pkg-backup(8), pkg-check(8), pkg-clean(8), pkg-
     config(8), pkg-create(8), pkg-delete(8), pkg-fetch(8), pkg-info(8), pkg-in-
     stall(8), pkg-lock(8),  pkg-query(8),  pkg-register(8),  pkg-repo(8),  pkg-
     rquery(8),  pkg-search(8),  pkg-set(8),  pkg-shell(8),  pkg-shlib(8),  pkg-
     ssh(8), pkg-stats(8), pkg-update(8), pkg-updating(8), pkg-upgrade(8),  pkg-
     version(8), pkg-which(8)

FreeBSD 13.0			  May 25, 2014			      PKG-ADD(8)
home | help