dh_cligacpolicy - creates and installs a CLI policy file for a package
Contents
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.
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
File Format
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.
VersionRange 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.
Assemblyversion 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.
Name
dh_cligacpolicy - creates and installs a CLI policy file for a package
Notes
Note that this command is not idempotent. "dh_prep" should be called between invocations of this command.
Otherwise, it may cause multiple instances of the same text to be added to maintainer scripts.
Options
-n, --noscripts
Do not modify postinst/prerm scripts.
See Also
debhelper(7)
This program is a part of cli-common-dev.
Synopsis
dh_cligacpolicy [debhelperoptions] [-n]
