get_nis_map_with_comment
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 includes the comment field for map entries. The get_nis_map_with_comment
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_with_command
Abbreviation
gnmwc
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
- The comment
Each entry component is separated from the next by a colon (:).
Examples
get_nis_map_with_comment
This example returns the map entries including comments:
{Finance:1: Hank@acme.com,jane@acme.com,joe@acme.com: Finance dept staff} {Mktg:1: Mike@acme.com,Sue@acme.com: Marketing dept staff}
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_field reads a field value from the currently selected NIS map.
- get_nis_maps returns a Tcl list of NIS maps in the currently selected zone.
- list_nis_map or list_nis_map_with_comment lists to
stdout
of the entries in the currently selected NIS map.