OpenBSD manual page server

Manual Page Search Parameters

PKG_SUBST(1) General Commands Manual PKG_SUBST(1)

pkg_substsubstitute variables' values in files

pkg_subst [-ci] [-B basedir] [-D name[=value]] [-g group] [-m mode] [-o owner] [file ...]

pkg_subst is used within the ports tree to substitute variable values, using the exact same conventions used by pkg_create(1). Constructs like ${VAR} will be replaced with the variable value, according to -D name[=value] options.

The options are as follows

basedir
Specify a basedir in which we know file properties. It is forbidden to copy files from elsewhere without -m mode.
Copy and substitute. Number of file arguments must be even. They are paired as src1 dest1, src2 dest2 ... and each src file is substituted and copied into the corresponding dest file.
name[=value]
Define name to value, or to 1 if no value is given.
group
Change group of destination file to group.
Ignore changes to group or owner that failed.
mode
Change mode of destination file to mode.
owner
Change owner of destination file to owner.

If no file arguments is given, pkg_subst acts as a filter from stdin to stdout.

Without -c, each file is backed up as file.beforesubst before the substitution occurs.

install(1), pkg_create(1)

June 26, 2018 OpenBSD-6.6