GETENT(1)

ИМЯ
getent - возвращает записи из библиотек диспетчера службы имён

ОБЗОР
getent [параметр]... база_данных ключ...

ОПИСАНИЕ
Команда getent отображает записи из баз данных, поддерживаемых библиотеками диспетчера службы имён (Name Service Switch), которые настраиваются в /etc/nsswitch.conf. Если указан один или более аргументов ключ, то отображаются только записи, совпадающие с заданными ключами. В противном случае, если ключ не указан, то будут показаны все записи (если база данных поддерживает перечисление).

Значение базы данных может быть любым из поддерживаемых библиотекой GNU C:

    ahosts
        Если ключ не указан, то используются sethostent(3), gethostent(3) и endhostent(3) для перечисления базы данных hosts. Идентично использованию hosts. Если указан один или более ключ, то каждый ключ последовательно передаётся в getaddrinfo(3) с адресным семейством AF_UNSPEC, которая возвращает каждую перечисляемую адресную структуру сокета.

    ahostsv4
        То же, что и ahosts, но используется адресное семейство AF_INET.

    ahostsv6
        То же, что и ahosts, но используется адресное семейство AF_INET6. В этом случае при вызове getaddrinfo(3) включается флаг AI_V4MAPPED.

    aliases
        Если ключ не указан, используется setaliasent(3), getaliasent(3) и endaliasent(3) для перечисления базы данных aliases. Если указан один или более ключ, то каждый ключ последовательно передаётся в getaliasbyname(3) и показывается результат.

    ethers
        Если указан один или более ключ, то каждый ключ последовательно передаётся в ether_aton(3) и ether_hostton(3), пока не будет возвращён результат, и показывается результат. Перечисление ethers не поддерживается, поэтому ключ обязателен.

    group
        Если ключ не указан, используется setgrent(3), getgrent(3) и endgrent(3) для перечисления базы данных group. Если указан один или более ключ, то каждый числовой ключ передаётся в getgrgid(3) и каждый не числовой ключ в getgrnam(3) и показывается результат.

    gshadow
        Если ключ не указан, используется setsgent(3), getsgent(3) и endsgent(3) для перечисления базы данных gshadow. Если указан один или более ключ, то каждый ключ последовательно передаётся в getsgnam(3) и показывается результат.

    hosts
        Если ключ не указан, используется sethostent(3), gethostent(3) и endhostent(3) для перечисления базы данных hosts. Если указан один или более ключ, то каждый ключ последовательно передаётся в gethostbyaddr(3) или gethostbyname2(3), в зависимости от результата вызова inet_pton(3), определяющего, является ли ключ адресом IPv6 или IPv4, и показывается результат.

    initgroups
        Если указан один или более ключ, то каждый ключ последовательно передаётся в getgrouplist(3) и показывается результат. Перечисление initgroups не поддерживается, поэтому ключ обязателен.

    netgroup
        Если указан один ключ, то он передаётся в setnetgrent(3) и, с помощью getnetgrent(3), отображается полученная строковая тройка (hostname, username, domainname). В противном случае могут быть указаны три ключа, которые рассматриваются как hostname, username и domainname для поиска имени netgroup посредством innetgr(3). Перечисление netgroup не поддерживается, поэтому должен быть указан либо один, либо три ключа.

    networks
        Если ключ не указан, используется setnetent(3), getnetent(3) и endnetent(3) для перечисления базы данных networks. Если указан один или более ключ, то каждый числовой ключ передаётся в getnetbyaddr(3) и каждый не числовой ключ в getnetbyname(3) и показывается результат.

    passwd
        Если ключ не указан, используется setpwent(3), getpwent(3) и endpwent(3) для перечисления базы данных passwd. Если указан один или более ключ, то каждый числовой ключ передаётся в getpwuid(3) и каждый не числовой ключ в getpwnam(3) и показывается результат.

    protocols
        Если ключ не указан, используется setprotoent(3), getprotoent(3) и endprotoent(3) для перечисления базы данных protocols. Если указан один или более ключ, то каждый числовой ключ передаётся в getprotobynumber(3) и каждый не числовой ключ в getprotobyname(3) и показывается результат.

    rpc Если ключ не указан, используется setrpcent(3), getrpcent(3) и endrpcent(3) для перечисления базы данных rpc. Если указан один или более ключ, то каждый числовой ключ передаётся в getrpcbynumber(3) и каждый не числовой ключ в getrpcbyname(3) и показывается результат.

    services
        Если ключ не указан, используется setservent(3), getservent(3) и endservent(3) для перечисления базы данных services. Если указан один или более ключ, то каждый числовой ключ передаётся в getservbynumber(3) и каждый не числовой ключ в getservbyname(3) и показывается результат.

    shadow
        Если ключ не указан, используется setspent(3), getspent(3) и endspent(3) для перечисления базы данных shadow. Если указан один или более ключ, то каждый ключ последовательно передаётся в getspnam(3) и показывается результат.

ПАРАМЕТРЫ

-s служба, --service служба
    Заменить все базы данных с указанной службой (начиная с glibc 2.2.5).

-s база_данных:служба, --service база_данных:служба
    Заменить только указанные базы данных с указанной службой. Параметр может указываться несколько раз, но будет использоваться только последняя служба для каждой базы данных (начиная с glibc 2.4).

-i, --no-idn
    Отключить кодировку IDN в поиске ahosts/getaddrinfo(3) (начиная с glibc-2.13).

-?, --help
    Показать справку по использованию и завершить работу.

--usage
    Показать краткую справку по использованию и завершить работу.

-V, --version
    Показать номер версии, лицензию и уведомление о гарантиях для getent.

КОД РЕЗУЛЬТАТА
Программа getent может возвращать один из следующих кодов завершения:

    0   Команда успешно выполнена.

    1   Отсутствуют аргументы или неизвестная база данных.

    2   Один или более указанных ключей невозможно найти в базе данных.

    3   Перечисление не поддерживается в этой базе данных.

СМОТРИТЕ ТАКЖЕ
nsswitch.conf(5)