ОБЗОР
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 Перечисление не поддерживается в этой базе данных.
