Solaris Naming Administration Guide

NIS+ De-Bugging Options

The NIS_OPTIONS environment variable can be set to control various NIS+ debugging options.

Options are specified after the NIS_OPTIONS command separated by spaces with the option set enclosed in double quotes. Each option has the format name=value. Values can be integers, character strings, or filenames depending on the particular option. If a value is not specified for an integer value option, the value defaults to 1.

NIS_OPTIONS recognizes the following options:

Table A-1 NIS_OPTIONS Options and Values


Option	Values	Actions
`debug_file`	`filename`	Directs debug output to specified file. If this option is not specified, debug output goes to `stdout`.
`debug_bind`	`Number`	Displays information about the server selection process.
`debug_rpc`	`1` or `2`	If the value is 1, displays RPC calls made to the NIS+ server and the RPC result code. If the value is 2, displays both the RPC calls and the contents of the RPC and arguments and results.
`debug_calls`	`Number`	Displays calls to the NIS+ API and the results that are returned to the application.
`pref_srvr`	`String`	Specifies preferred servers in the same format as that generated by the `nisprefadm` command (see Table 14-1). This will over-ride the preferred server list specified in `nis_cachemgr`.
`pref_type`	`String`	Not currently implemented.

For example, (assuming that you are using a C-Shell):

To display many debugging messages you would enter:

setenv NIS_OPTIONS "debug_calls=2 debug_bind debug_rpc"

To obtain a simple list of API calls and store them in the file /tmp/CALLS you would enter:

setenv NIS_OPTIONS "debug_calls debug_file=/tmp/CALLS"