NAME¶
dh_cligacpolicy - creates and installs a CLI policy file for a package
SYNOPSIS¶
dh_cligacpolicy [
debhelper options] [
-n]
DESCRIPTION¶
dh_cligacpolicy is a debhelper program that is responsible for creating,
compiling, and installing policy files for a Debian package. This
automatically includes postinst and prerm commands needed to install these
policies into the system.
OPTIONS¶
- -n, --noscripts
- Do not modify postinst/prerm scripts.
This file uses the
debian/cligacpolicy files (either
policyassemblies or
debian/packagename.cligacpolicy) to generate
the policy file. It supports multiple versions of the policy, including
mapping multiple versions to a single file.
The file format of the
cligacpolicy file consists of five properties per
line, each one separated by whitespace.
- Keyfile is a path, from the package root, to the .snk file used to
sign the assembly.
- Assembly is the name of the assembly, without the .dll extension.
For example, for log4net.dll, use log4net.
- Version Range can be a single four-part version, such as 1.2.3.4,
or a full range, such as 1.2.3.4-1.2.6.7. For a single line, the first two
numbers must be identical. To have an assembly apply to multiple versions,
such as 1.2.0.0 to 2.4.0.0, there needs to be one line for each version
range.
- Assembly version is the version of the assembly being =built.
- Priority defines the priority of the policy files. Typically, each
version will increase the priority and contains all the policy controls for
prior versions.
The fields can be separated with spaces or tabs. Comments start the line with
# characters and blank lines are ignored.
NOTES¶
Note that this command is not idempotent. "dh_clean -k" should be
called between invocations of this command. Otherwise, it may cause multiple
instances of the same text to be added to maintainer scripts.
EXAMPLE¶
For the log4net 1.2.10.0 version, a policy file is used to map all versions from
1.2.8.0 to 1.2.9.99 into the current version.
debian/log4net.snk log4net 1.2.8.0-1.2.9.99 1.2.10.0 10
SEE ALSO¶
debhelper(7)
This program is a part of cli-common-dev.
AUTHOR¶
Dylan R. E. Moonfire <debian@mfgames.com>