.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_PPP 1p"
.TH DH_PPP 1p "2023-09-10" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
dh_ppp \- calculate ppp dependencies
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBdh_ppp\fR [\fIdebhelper options\fR] [\fB\-\-breaks\fR] [\fB\-\-force\fR] [\fB\-\-plugin\-dir\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdh_ppp\fR is a debhelper program that adds appropriate ppp dependencies on
packages that build pppd plugins.
.PP
By default, some entries are added to \fBmisc:Depends\fR that ensure that
packages which contain plugins that are loaded into pppd depend on an
appropriate version of the ppp package.
.PP
You may prefer to use a \fBBreaks\fR 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 \fB\-\-breaks\fR option and \fBmisc:Breaks\fR will be
populated instead of \fBmisc:Depends\fR.
.PP
Substvars entries are only added if a pppd plugin is detected in the build
products, unless \fB\-\-force\fR is specified. Plugins are detected by searching a
package's build products for libraries with a symbol named \fBplugin_init\fR.
.PP
A warning is emitted if a plugin is found that does not also contain a
\&\fBpppd_version\fR symbol.
.PP
Please note there is a \fBdh\fR addon named \fBppp\fR which can be used to
automatically invoke \fBdh_ppp\fR for you.
.SH "FILES"
.IX Header "FILES"
.IP "/usr/share/ppp\-dev/substvars" 4
.IX Item "/usr/share/ppp-dev/substvars"
Template substitution variables. The values in this file are used when
populating the \fBmisc:Depends\fR or \fBmisc:Breaks\fR substition variables, or they
may be manually copied into a package's substvars if one wishes not to use
\&\fBdh_ppp\fR.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-breaks\fR" 4
.IX Item "--breaks"
Rather than populating \fBmisc:Depends\fR to ensure an appropriate version of
\&\fBppp\fR is used, populate \fBmisc:Breaks\fR such that a inappropriate version of
\&\fBppp\fR may not be used.
.IP "\fB\-\-force\fR" 4
.IX Item "--force"
Do not try to detect pppd plugins in the package, and always assume that a
plugin is present. This will cause \fBmisc:Depends\fR (or \fBmisc:Breaks\fR) to
always be populated.
.IP "\fB\-\-plugin\-dir\fR" 4
.IX Item "--plugin-dir"
Simply outputs the path to the pppd plugins directory for the current \s-1ABI\s0
version. When this flag is specified, \fBdh_ppp\fR makes no attempt to detect any
plugins nor does it update any substitution variables.
.SH "NOTES"
.IX Header "NOTES"
Note that this command is not idempotent. \fBdh_prep\fR\|(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.
.PP
Note that \fBdh_ppp\fR should be run before \fBdh_gencontrol\fR. The \fBppp\fR sequence
addon for \fBdh\fR does the right thing, this note is only relevant when you are
calling \fBdh_ppp\fR manually.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdebhelper\fR\|(7)
.SH "AUTHORS"
.IX Header "AUTHORS"
Chris Boot <bootc@debian.org>