1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
|
# pod2man --section=8 --release="nss-docker" --center=" " --date="20 Oct 2015"
#
=head1 NAME
nss-docker - nss module for finding Docker containers
=head1 SYNOPSIS
libnss_docker.so.2
=head1 DESCRIPTION
This is a plugin for the GNU Name Service Switch (NSS) functionality of the GNU
C Library (glibc) providing mechanism for finding Docker containers by theirs
IDs.
The container names are searched in virtual domain name C<.docker>.
The Docker API webservice has to be available as F</var/run/docker.sock> socket
for current user. Usually it requires to add the user to C<docker> system
group.
To activate this NSS module, the C<docker> module has to be added to
F</etc/nsswitch.conf> file in C<hosts:> line.
It is recommended to put the C<docker> module after C<files> module and before
C<dns> module. C<[NOTFOUND=return]> setting is recommended before C<dns> module
to prevent using DNS as fallback if the container ID is not found.
=head1 EXAMPLE
=head2 F</etc/nsswitch.conf>
hosts: files docker [NOTFOUND=return] dns
=head1 SEE ALSO
docker(1), nsswitch.conf(5)
=head1 LIMITATIONS
The container ID can't be longer than C<getconf HOST_NAME_MAX> (64 for Linux).
The container ID are case sensitive. It means that C<test.docker> and
C<Test.docker> can return different IP addresses.
Only IPv4 addresses are supported.
=head1 BUGS
If you find the bug or want to implement new features, please report it at
L<https://github.com/dex4er/nss-docker/issues>
=head1 AUTHORS
Copyright (c) 2015 Piotr Roszatycki <dexter@debian.org>
=head1 COPYING
nss-docker is distributed under the GNU Lesser General Public License (LGPL
2.1 or greater).
|