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}

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.