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}

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.