NAME

       dh_ppp - calculate ppp dependencies

SYNOPSIS

       dh_ppp [debhelper options] [--breaks] [--force] [--plugin-dir]

DESCRIPTION

       dh_ppp is a debhelper program that adds appropriate ppp dependencies on packages that
       build pppd plugins.

       By default, some entries are added to misc:Depends that ensure that packages which contain
       plugins that are loaded into pppd depend on an appropriate version of the ppp package.

       You may prefer to use a Breaks relationship instead, for example if your package supplies
       a pppd plugin but does not require it for normal operation. In that case you should supply
       the --breaks option and misc:Breaks will be populated instead of misc:Depends.

       Substvars entries are only added if a pppd plugin is detected in the build products,
       unless --force is specified. Plugins are detected by searching a package's build products
       for libraries with a symbol named plugin_init.

       A warning is emitted if a plugin is found that does not also contain a pppd_version
       symbol.

       Please note there is a dh addon named ppp which can be used to automatically invoke dh_ppp
       for you.

FILES

       /usr/share/ppp-dev/substvars
           Template substitution variables. The values in this file are used when populating the
           misc:Depends or misc:Breaks substition variables, or they may be manually copied into
           a package's substvars if one wishes not to use dh_ppp.

OPTIONS

       --breaks
           Rather than populating misc:Depends to ensure an appropriate version of ppp is used,
           populate misc:Breaks such that a inappropriate version of ppp may not be used.

       --force
           Do not try to detect pppd plugins in the package, and always assume that a plugin is
           present. This will cause misc:Depends (or misc:Breaks) to always be populated.

       --plugin-dir
           Simply outputs the path to the pppd plugins directory for the current ABI version.
           When this flag is specified, dh_ppp makes no attempt to detect any plugins nor does it
           update any substitution variables.

NOTES

       Note that this command is not idempotent. dh_prep(1) should be called between invocations
       of this command (with the same arguments). Otherwise, it may cause multiple instances of
       the same text to be added to the substition variables.

       Note that dh_ppp should be run before dh_gencontrol. The ppp sequence addon for dh does
       the right thing, this note is only relevant when you are calling dh_ppp manually.

SEE ALSO

       debhelper(7)

AUTHORS

       Chris Boot <bootc@debian.org>