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¶
- debian/package.nss
- 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¶
This program is a debhelper addon.
AUTHOR¶
Gioele Barabucci <gioele@svario.it>
2022-08-24 | perl v5.34.0 |