JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
System Administration Guide: Naming and Directory Services (NIS+)
search filter icon
search icon

Document Information


Part I About Naming and Directory Services

1.  Name Service Switch

Part II NIS+ Setup and Configuration

2.  NIS+: An Introduction

3.  NIS+ Setup Scripts

4.  Configuring NIS+ With Scripts

5.  Setting Up the NIS+ Root Domain

6.  Configuring NIS+ Clients

7.  Configuring NIS+ Servers

8.  Configuring an NIS+ Non-Root Domain

9.  Setting Up NIS+ Tables

Part III NIS+ Administration

10.  NIS+ Tables and Information

11.  NIS+ Security Overview

12.  Administering NIS+ Credentials

13.  Administering NIS+ Keys

14.  Administering Enhanced NIS+ Security Credentials

15.  Administering NIS+ Access Rights

16.  Administering NIS+ Passwords

17.  Administering NIS+ Groups

18.  Administering NIS+ Directories

19.  Administering NIS+ Tables

NIS+ Table Administration

Using the nistbladm Command With NIS+ Tables

nistbladm Syntax Summary

nistbladm and NIS+ Column Values

nistbladm, Searchable NIS+ Columns, Keys, and Column Values

nistbladm and Indexed NIS+ Names

nistbladm and NIS+ Groups

Creating a New NIS+ Table

Specifying NIS+ Table Columns

Creating Additional NIS+ Automount Tables

Deleting an NIS+ Table

Adding Entries to an NIS+ Table

Adding an NIS+ Table Entry With the -a Option

Adding an NIS+ Table Entry With the -A Option

Modifying NIS+ Table Entries

Editing an NIS+ Table Entry With the -e Option

Editing an NIS+ Table Entry With the -E Option

Removing NIS+ Table Entries

Removing NIS+ Single Table Entries

Removing Multiple Entries From an NIS+ Table

niscat Command

niscat Command Syntax

Displaying the Contents of an NIS+ Table

Displaying the Object Properties of an NIS+ Table or Entry

nismatch and nisgrep Commands

About Regular Expressions in NIS+

nismatch and nisgrep Command Syntax

Searching the First Column in NIS+

Searching a Particular Column in NIS+

Searching Multiple Columns in NIS+

nisln Command

nisln Command Syntax

Creating a Link in NIS+

nissetup Command

Expanding a Directory Into an NIS+ Domain

Expanding a Directory Into an NIS-Compatible Domain

nisaddent Command

nisaddent Command Syntax

Loading Information Into NIS+ From a File

Loading Data From an NIS Map Into NIS+

Dumping the Contents of an NIS+ Table to a File

20.  NIS+ Server Use Customization

21.  NIS+ Backup and Restore

22.  Removing NIS+

23.  Information in NIS+ Tables

24.  NIS+ Troubleshooting

A.  NIS+ Error Messages

About NIS+ Error Messages

Common NIS+ Namespace Error Messages

B.  Updates to NIS+ During the Solaris 10 Release

Solaris 10 and NIS+



Modifying NIS+ Table Entries

Existing table entries are edited (modified) using either the -e or -E options. The Solaris release also supports use of the -m option for backwards compatibility with earlier releases. (All new applications and command line operations should use either the -e or -E options.)

To edit an existing entry (row) in a table, use nistbladm with either the -e or -E options followed by one or more column=value pairs that specify the new values and ending with an indexed name that identifies a particular row in a table as described in nistbladm and Indexed NIS+ Names.

nistbladm [-e | -E] column="value" \
 column="value" \
 ... indexedname

When adding new entry rows to a table with either -e or -E:

Editing an NIS+ Table Entry With the -e Option

The -e option edits an entry in a table unless doing so would result in changing values in searchable columns in more than one entry row, in which case it returns an error. (The values in non-searchable columns are not taken into account.)

nistbladm column="value" \
 column="value" \
 ... indexedname

To use the -e option, you only need to specify the column values you are changing.

For example, suppose you had the table:


To change the value of the Name column to Chandar, you would enter:

master% nistbladm -e Name="Chandar" [Dept='Sales',Site='SanFran'],\

Now the table looks like this:


(Note that in the example above, the indexed name did not need to include the Name column because in these examples that column is not searchable.)

C-shell users should also use quotes to set off expressions using square brackets.

You can use the -e option to edit the values in searchable columns so long as the new values you specify affect only the single row identified by the indexed name. For example, to change the department to Manf, you would enter:

master% nistbladm -e Dept="Manf" [Dept='Sales',Site='SanFran'],\
Dept (searchable)
Site (searchable)

However, if an entry row already existed with Manf and SanFran in the searchable columns, the -e option would return an error.

You can specify changes to multiple columns so long as they all apply to a single entry row. For example, to change both the Dept and Name values, you would enter:

master% nistbladm -e Dept="Manf" Name=”Thi” \
Dept (searchable)
Site (searchable)

Editing an NIS+ Table Entry With the -E Option

The -E option is designed for applications where you need to force nistbladm to overwrite an existing entry even if doing so will affect more than one entry.

For example, suppose your table had the following rows:

Dept (searchable)
Site (searchable)

Now you run the following command:

master% nistbladm -E Site="Alameda” Mgr="Chu" \

Which would change the Sales SanFran Chandar row to Sales Alameda Chu. But Sales Alameda are the key values identifying the Sales Alameda Achmed row, so that row would also be changed. The result would be a single row where once there had been two rows:

Dept (searchable)
Site (searchable)

The -e option would have returned an error, since the edit would affect more than one row. But the -E option allows you to affect more than one entry row.