.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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_VARNISHABI 1p"
.TH DH_VARNISHABI 1p 2025-03-18 "perl v5.40.1" "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_varnishabi \- calculate the Varnish ABI dependencies
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBdh_varnishabi\fR [\fIdebhelper\ options\fR] [\fB\-\-strict\fR] [\fB\-\-force\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBdh_varnishabi\fR is a debhelper program that adds appropriate
\&\fIvarnishabi\-*\fR dependencies on packages that build varnish modules.
.PP
By default, a \fIvarnishabi\-*\fR entry is added to \fBmisc:Depends\fR to
ensure that packages which contain modules that are loaded by Varnish
depend on an appropriate version of the \fIvarnish\fR package.
.PP
If \fB\-\-strict\fR is specified, then a dependency on \fIvarnishabi\-strict\-*\fR
is added too.
.PP
When building the varnish binary package the program will generate instead
\&\fBmisc:Provides\fR entries for \fIvarnishabi\-*\fR and \fIvarnishabi\-strict\-*\fR.
.PP
Substvars entries are only added if a Varnish module is detected in
the build products, unless \fB\-\-force\fR is specified.
Modules are detected by searching a package's build products for
libraries installed in the Varnish vmods directory and containing a
symbol named \fBvmod_version\fR.
.PP
Please note there is a \fBdh\fR addon named \fBvarnishabi\fR which can be used to
automatically invoke \fBdh_varnishabi\fR for you.
.SH OPTIONS
.IX Header "OPTIONS"
.IP \fB\-\-force\fR 4
.IX Item "--force"
Do not try to detect Varnish modules in the package, and always assume that a
module is present. This will cause \fBmisc:Depends\fR to always be populated.
.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_varnishabi\fR should be run before \fBdh_gencontrol\fR.
The \fBvarnishabi\fR sequence addon for \fBdh\fR does the right thing, this
note is only relevant when you are calling \fBdh_varnishabi\fR manually.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdebhelper\fR\|(7)
.SH AUTHOR
.IX Header "AUTHOR"
Originally written by Chris Boot <bootc@debian.org> as \fBdh_ppp\fR\|(7),
then Marco d'Itri <md@linux.it> modified it for Varnish.