list_nis_map

Use the list_nis_map command to return a list of all map entries within the currently selected NIS map. If executed in a script, this command outputs its list to stdout so that the output appears in the shell where the script is executed. The command does not return a Tcl list back to the executing script. Use get_nis_map to return a Tcl list of NIS map entries.

Zone type

Not applicable

Syntax

list_nis_map

Abbreviation

lsnm

Options

This command takes no options.

Arguments

This command takes no arguments.

Return value

This command returns a list to stdout of the map entries for the currently selected NIS map. Each map entry in the list contains the following fields separated by colons (:):

  • The key
  • The instance number of the key
  • The value

Examples

list_nis_map

This example returns map entries similar to the following:

Finance:1:Hank@acme.com,jane@acme.com,joe@acme.com
Mktg:1:Mike@acme.com,Sue@acme.com

Related commands

Before you use this command, you must have a currently selected NIS map stored in memory. The following commands enable you to view and select a NIS map:

  • get_nis_maps returns a Tcl list of NIS maps in the currently selected zone.
  • list_nis_maps returns a list to stdout of all NIS maps in the currently selected zone.
  • new_nis_map creates a new NIS map and stores it in memory.
  • select_nis_map retrieves a NIS map from Active Directory and stores it in memory.

After you have a NIS map stored in memory, you can use the following commands to work with that map: