nsquery.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

nsquery(1) nsquery(1)

NAME

nsquery - query the Name Service Switch backend libraries

SYNOPSIS

nsquery lookup_type lookup_query [lookup_policy]

DESCRIPTION

nsquery is used to ﬁnd the Name Service that returned the response to a

getaddrinfo()

, gethost-

byname(), gethostbyaddr()

, getnameinfo()

, getpwnam(), getpwuid(), getgrnam(),or

getgrgid() function call. This application is Name Service Switch aware and follows the lookup poli-

cies in /etc/nsswitch.conf

. The supported lookup_type values are:

hosts Used to resolve host name or IP Address lookups.

passwd Used to resolve user name or UID lookups. Assumes that a numeric value is a UID.

This option is to be obsoleted. Use pwname

and pwuid instead.

pwname Used to resolve user name lookups.

pwuid Used to resolve UID lookups.

group Used to resolve group name or GID lookups. Assumes that a numeric value is a

GID. This option is to be obsoleted. Use

grname and grgid instead.

grname Used to resolve group name lookups.

grgid Used to resolve GID lookups.

ipnodes Used to resolve host name or IP Address lookups. Only IPv6 and IPv4-mapped IPv6

address will be displayed for host name lookups.

The lookup_query can either be a host name, IP Address (IPv4 only), user name, user ID, group name, or

group ID.

The lookup_policy must be a valid lookup policy described in nsswitch.conf(4). If the policy is invalid, the

system default policy will be used. The default values for lookup_policy are:

hosts dns [NOTFOUND=return] nis [NOTFOUND=return] ﬁles

passwd ﬁles nis

group ﬁles nis

ipnodes dns [NOTFOUND=return] ﬁles

nsquery will display the lookup policy being used, the name of the service being queried, and the result

of the query.

EXAMPLES

Lookup host hondo using the default hosts lookup policy.

nsquery hosts hondo

Lookup host with ip address 15.204.204.204 using "dns ﬁles" as the hosts lookup policy.

nsquery hosts 15.204.204.204 "dns files"

Lookup user dog using "ldap" as the passwd lookup policy.

nsquery passwd dog "ldap"

Lookup user ID 105 using the default passwd lookup policy.

nsquery pwuid 105

Lookup group wayne using group lookup policy "nis [NOTFOUND=RETURN] ﬁles".

nsquery grname wayne "nis [NOTFOUND=RETURN] files"

Lookup group 22 using the default group lookup policy.

nsquery group 22

Lookup host rio using "dns" as the ipnodes lookup policy.

nsquery ipnodes rio "dns"

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)

PAGE 1
nsquery(1) nsquery(1) NAME nsquery - query the Name Service Switch backend libraries SYNOPSIS nsquery lookup_type lookup_query [lookup_policy] DESCRIPTION nsquery is used to find the Name Service that returned the response to a getaddrinfo(), gethostbyname(), gethostbyaddr(), getnameinfo(), getpwnam(), getpwuid(), getgrnam(), or getgrgid() function call. This application is Name Service Switch aware and follows the lookup policies in /etc/nsswitch.conf.
PAGE 2
nsquery(1) nsquery(1) RETURN VALUE nsquery returns the following values: 0 1 2 3 Success. Invalid Usage. Unknown Action. No match found in any name services queried. WARNINGS The passwd and group lookup_type values are to be obsoleted. For passwd, use pwname or pwuid instead. For group, use grname or grgid instead. AUTHOR nsquery was developed by Hewlett-Packard. SEE ALSO nsswitch.conf(4).