Scroll to navigation

DH_INSTALLNSS(1) User Contributed Perl Documentation DH_INSTALLNSS(1)

NAME

dh_installnss - enable NSS services

SYNOPSIS

dh_installnss [debhelper options]

DESCRIPTION

dh_installnss is a debhelper program that is responsible for injecting NSS (Name Service Switch) services into /etc/nsswitch.conf.

FILES

Lists the services to inject into /etc/nsswitch.conf when a package is configured and to remove when a package is removed or purged.

Each line in that file should be of the form

"db position service action condition"

where the fields contain the following pieces of information:

"db": the NSS database in which the service will be added. Usually "hosts".
"position": where to add the NSS service.
Possible values are "first", "last", "before=service", "after=service", plus the pseudo-positions "remove-only" and "database".

The pseudo-position "remove-only" is used to mark services that are not going to be added during the installation of the package, but that will be removed during its removal (e.g., legacy services).

The pseudo-position "database" is used to request the addition of a non-standard NSS database. When "database" is used, all other fields should be left empty.

"service": the name of the NSS service to add.
"action": optional action specification "[STATE=ACTION]".
"condition": optional set of conditions to better define when a service should (or should not) be installed. Only one kind of condition is currently defined: "skip-if-present=service,service,...".

Additionally, text between a "#" character and the end of line is ignored.

EXAMPLES

An example debian/nss file could look like this:

    hosts before=dns mdns4
    hosts before=mdns4 mdns4_minimal [NOTFOUND=return]
    hosts remove-only mdns    # In case the user manually added it

After the installation of this package, the original configuration of the hosts database in /etc/nsswitch.conf will change from:

    hosts:    files dns

to:

    hosts:    files mdns4_minimal [NOTFOUND=return] mdns4 dns

SEE ALSO

debhelper(7)

This program is a debhelper addon.

AUTHOR

Gioele Barabucci <gioele@svario.it>

2022-08-24 perl v5.34.0