NAME

pkgman.conf — configuration file for pkgman

SYNOPSIS

DESCRIPTION

This manual page describes the format of the pkgman.conf file, that contains information for pkgman(1).

Every line can contain one configuration option. The format of the lines is “key value”. Any lines beginning with a hash mark (‘#’) is ignored, as are lines containing only whitespace or empty lines.

The valid configuration options are:

pkgsrcdir path[:pkg[,...]]

The location where to look for the packages sources. The order of the “pkgsrcdir” options is important as if a package is in multiple directories, pkgman(1) will use the one found first (directories listed first have precedence).

If you want to restrict the packages used from one “pkgsrcdir”, you can append a comma-separated list of packages to be used after the path, using a colon mark (‘:’) to separate the two components.

path

The directory.

pkg

The final directory in the path.

Example:

# Use all packages from the path.
pkgsrcdir /usr/src/pkgsrc-core

# Use only mpv and ffmpeg packages from the path.
pkgsrcdir /usr/src/pkgsrc-desktop:mpv,ffmpeg

runscripts yes|no

Run pre/post-install and pre/post-remove scripts. Influences pkgman-install(8), pkgman-update(8), and pkgman-sysup(8) operations.

By default “no”.

preferhigher yes|no

If set to yes, pkgman(1) will parse version strings and prefer the higher one, even if the one found in the packages sources directories is lower. Influences pkgman-diff(1) and pkgman-sysup(8) operations.

By default “no”.

useregex yes|no

If set to yes, pkgman(1) will interpret “expr” and “filter” patterns in pkgman-list(1), pkgman-printf(1), pkgman-search(1), pkgman-dsearch(1), and pkgman-fsearch(1) operations as regular expression in regex(3) format.

By default “no”.

readme verbose|compat|disabled

If the readme option is set to something different that disabled, pkgman(1) will notify the user if installed package has a README file.

verbose

Print separate information about README files.

compact

Integrate in the result output.

disabled

No information about README files.

See pkgman-readme(1) for information how to read those README files.

By default “verbose”.

writelog enabled|disabled

Write the log for pkgman-sysup(8), pkgman-install(8), pkgman-update(8), and pkgman-remove(8) operations.

By default “disabled”.

logmode append|overwrite

Write log mode.

By default “overwrite”.

rmlog_on_success yes|no

When set to yes, log files of successful build will be removed.

logfile format

The string that contains a path to the log file, where all occurrences of next characters will be replaced by corresponding items:

Variable	Description
%n	package name
%p	package path
%v	package version
%r	package release number

Example: “/var/log/pkgbuild/%n.log”

Unset by default.

makecommand command

Use an alternate command instead of pkgmk(8) for the command which is used to build the package.

addcommand command

Use an alternate command instead of pkgadd(8) for the command which is used to install the package.

removecommand command

Use an alternate command instead of pkgrm(8) for the command which is used to remove the package.

runscriptcommand command

Use an alternate command instead of sh(1p) for the command which is used to run the pre/post-install and pre/post-remove scripts.

EXAMPLES

#
# /etc/pkgman.conf: pkgman(1) configuration
#
# See pkgman.conf(5) for more information.
#

# use local directory first
#pkgsrcdir /path/to/unofficial/pkgsrcs/

# zeppe-lin official
pkgsrcdir /usr/src/pkgsrc-core
pkgsrcdir /usr/src/pkgsrc-system
pkgsrcdir /usr/src/pkgsrc-xorg
pkgsrcdir /usr/src/pkgsrc-desktop

# log options
writelog enabled
logmode overwrite
rmlog_on_success yes
logfile /var/log/pkgbuild/%n.log

# notify the user about README files
readme verbose

# do not prefer higher versions in sysup / diff
preferhigher no

# do not use regex search
useregex no

# run pre/post-install and pre/post-remove scripts
runscripts yes

# End of file.

SEE ALSO

pkgman(1)