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: