xenial (8) nss-mymachines.8.gz

NAME

       nss-mymachines, libnss_mymachines.so.2 - Provide hostname resolution for local container instances.

SYNOPSIS

       libnss_mymachines.so.2

DESCRIPTION

       nss-mymachines is a plugin for the GNU Name Service Switch (NSS) functionality of the GNU C Library
       (glibc), providing hostname resolution for container names of containers running locally that are
       registered with systemd-machined.service(8). The container names are resolved to the IP addresses of the
       specific container, ordered by their scope.

       The module also resolves user IDs used by containers to user names indicating the container name, and
       back.

       To activate the NSS modules, "mymachines" has to be added to the lines starting with "hosts:", "passwd:"
       and "group:" in /etc/nsswitch.conf.

       It is recommended to place "mymachines" near the end of the nsswitch.conf lines to make sure that its
       mappings are only used as fallback, and that any other mappings, such as DNS or /etc/hosts based
       mappings, take precedence.

EXAMPLE

       Here is an example /etc/nsswitch.conf file that enables mymachines correctly:

           passwd:         compat mymachines
           group:          compat mymachines
           shadow:         compat

           hosts:          files resolve mymachines myhostname
           networks:       files

           protocols:      db files
           services:       db files
           ethers:         db files
           rpc:            db files

           netgroup:       nis

SEE ALSO

       systemd(1), systemd-machined.service(8), nss-resolve(8), nss-myhostname(8), nsswitch.conf(5), getent(1)