get_nis_map
Use the get_nis_map
command to return a Tcl list containing the entries for the currently selected NIS map stored in memory. This command does not return the contents of the comment field. If you want to retrieve the comment, use get_nis_map_with_comment instead.
The get_nis_map
command does not query Active Directory for this NIS map, but changing map entries using add_map_entry
and delete_map_entry
changes both selected NIS map in memory and the corresponding NIS map in Active Directory so their contents should match.
Zone type
Not applicable
Syntax
get_nis_map
Abbreviation
gnm
Options
This command takes no options.
Arguments
This command takes no arguments.
Return value
This command returns a Tcl list of NIS map entries. Each entry contains:
- The key
- The instance number of the key (there may be multiple entries with the same key)
- The value
Each entry component is separated from the next by a colon (:).
Examples
get_nis_map
This example returns the list of map entries. For example:
{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 manage NIS maps:
- delete_nis_map deletes the selected NIS map from Active Directory and from memory.
- get_nis_maps returns a Tcl list of NIS maps in the currently selected zone.
- list_nis_maps lists to
stdout
all NIS maps in the currently selected zone. - new_nis_map creates a new NIS map and stores it in memory.
- save_nis_map saves the selected NIS map with its current entries to Active Directory.
- 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’s entries:
- add_map_entry or add_map_entry_with_comment adds an entry to the currently selected NIS map.
- delete_map_entry removes an entry from the currently selected NIS map.
- get_nis_map_with_comment returns a Tcl list of the entries in the currently selected NIS map.
- get_nis_map_field reads a field value from the currently selected NIS map.
- list_nis_map or list_nis_map_with_comment lists to
stdout
of the entries in the currently selected NIS map.