NAME

pkg.conf — system-wide package system configuration

DESCRIPTION

The file /etc/pkg.conf contains system-wide options related to package handling, as a list of ‘keyword=value’ lines.

In particular, the base system “installation-and-update” shell scripts record the URL used for the installation as installpath. pkg_add(1) can then add or replace packages from the same location straight after the install.

Currently defined options are as follows:

fullwidth

Set to yes if you really want to use the full width of the terminal for the progressmeter.

loglevel

pkg_add(1) and pkg_delete(1) will syslog(3) installations, updates and deletions by default. Set to 0 to avoid logging entirely. Levels higher than 1 may log more information in the future.

installpath

URL to package repository updated during installation. Used for accessing packages if the environment variable PKG_PATH is not defined and no further options are defined.

Special sequences ‘%a’, ‘%c’, ‘%m’, ‘%v’ will be expanded to ‘package architecture’, ‘OS version or snapshots’, ‘full mirror path’ and ‘OS version’ respectively. If a bare hostname is given, the standard /pub/OpenBSD path will be used automatically, e.g.

installpath = http://somesite.example.org/updates/%c/%a/
installpath += openbsd-mirror.example.org

should work.

nochecksum

Set to yes to waive checksums during package deletions.

ntogo

Set to yes to display (done/total) number of package messages.

Each option uses a separate line, and follows the following template:

keyword = value

A list of values can also be specified over several lines using the variation:

keyword += value
keyword += value
...

Keywords are case-insensitive.

Blank lines and comment lines (introduced by a #) are ignored.

Unknown keywords are ignored.

FILES

/etc/pkg.conf

SEE ALSO

pkg_add(1), pkg_create(1), pkg_delete(1), pkg_info(1), pkg_check(8)

HISTORY

The pkg.conf mechanism and format first appeared in OpenBSD 4.8.