.Dd September 22, 2013

.Nd Registers a package and installs it on the system

.Nm

.Op Fl IAfq

.Ar pkg-name ...

.Nm

.Op Fl IAfq

.Ar <protocol>://<path>/<pkg-name> ...

installs packages from either a local source or a remote one.

.Pp

When installing from a remote source you need to specify

the protocol to use when fetching the package.

.Pp

Currently supported protocols are FTP, HTTP and HTTPS.

.Pp

Otherwise,

.Nm

will read the file named on the command line.

.Pp

If this is a regular file, and the package to be installed has

unmet dependencies,

.Nm

will search the directory containing

.Ar pkg-name

for suitable pkg archive files to fulfill those dependencies.

If

.Ar pkg-name

is literally

.Pa -

then it will read the package data from stdin.

.Nm

will automatically detect and unpack most common compression formats

based on the content of the data stream it reads, ignoring any

extension the filename may have.

.Pp

If this involves reading from a pipe (including

.Pa stdin ) ,

fifo, socket or some other non-regular form of input stream then

.Nm

will immediately emit an error if

.Ar pkg-name

has unmet dependencies.

.Sh OPTIONS

The following options are supported by

.Nm :

.Bl -tag -width I1

.It Fl I

If any installation scripts (pre-install or post-install) exist for given

packages, do not execute them.

.It Fl A

Mark the installed packages as orphan.

Will be automatically removed if no other packages depend on them.

For more information please refer to

.Xr pkg-autoremove 8

.It Fl f

Force the reinstallation of the package if already installed.

.It Fl q

Force quiet output.

.El

.Sh ENVIRONMENT

The following environment variables affect the execution of

.Nm .

See

.Xr pkg.conf 5

for further description.

.Bl -tag -width ".Ev NO_DESCRIPTIONS"

.It Ev ASSUME_ALWAYS_YES

.It Ev HANDLE_RC_SCRIPTS

.It Ev PKG_DBDIR

.El