HP-UX Reference (11i v1 05/09) - 1 User Commands N-Z (vol 2)
n
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
gethostbyname()
,
gethostbyaddr()
, getpwnam(), getpwuid() , getgrnam() ,orgetgrgid() function call.
This application is Name Service Switch aware and follows the lookup policies in
/etc/nsswitch.conf
. The lookup types supported are:
hosts Used to resolve host name or IP Address lookups.
passwd Used to resolve user name or UID lookups.
group Used to resolve group name or GID lookups.
The lookup query can either be a host name, IP Address, 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 policies are:
hosts dns [NOTFOUND=return TRYAGAIN=return] nis [NOTFOUND=return] files
passwd files nis
group files nis
nsquery will display the lookup policy being used, the name of the service being queried, and the result of
the query.
If the result of the query was successful, the appropriate structure will be displayed.
EXAMPLES
nsquery hosts hondo
nsquery hosts 15.204.204.204 "dns files"
nsquery passwd dog "nisplus"
nsquery passwd 105
nsquery group wayne "nis [NOTFOUND=RETURN] files"
nsquery group 22
RETURN VALUE
nsquery returns the following values:
0 Success.
1 Invalid Usage.
2 Unknown ACTION.
3 No match found in any name services queried.
AUTHOR
nsquery was developed by Hewlett-Packard.
SEE ALSO
nsswitch.conf(4).
NOTES
Changing the default behavior for SUCCESS is not recommended.
Section 1−−664 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005