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(), or getgrgid() 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

0:: Success.
1:: Invalid Usage.
2:: Unknown ACTION.
3:: No match found in any name services queried.

AUTHOR

nsquery was developed by Hewlett-Packard.

NOTES

Changing the default behavior for SUCCESS is not recommended.

nsquery(1)

Technical documentation

» Table of Contents

» Index