HP-UX Reference (11i v1 05/09) - 1 User Commands N-Z (vol 2)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

nistbladm(1) nistbladm(1)

the add, the uppercase ‘A’ speciﬁes that the entry is to be added, even if it already

exists. This is analogous to a modify operation on the entry.

-c Create a table named tablename in the namespace. The table that is created must

have at least one column and at least one column must be searchable.

-d tablename Destroy the table named tablename. The table that is being destroyed must be

empty. The table’s contents can be deleted with the

-R option below.

-e |E Edit the entry in the table that is speciﬁed by indexdname. indexdname must

uniquely identify a single entry. It is possible to edit the value in a column that would

change the indexed name of an entry.

The change (colname=value) may affect other entries in the table if the change results

in an entry whose indexed name is different from indexedname and which matches

that of another existing entry. In this case, the

-e option will fail and an error will be

reported. The

-E option will force the replacement of the existing entry by the new

entry (effectively removing two old entries and adding a new one).

-m Modify an entry in the table that is speciﬁed by indexedname. Note: Since it is possi-

ble to modify the value in a column that would change the indexed name for an entry,

both the column value pair and the indexed name are required. It uses the indexed

name to look up the entry, modify it, and write it back with the new value. The

indexed name must uniquely identify a single entry.

-r |R Remove entries from a table. The entry is speciﬁed by either a series of column=value

pairs on the command line, or an indexed name that is speciﬁed as entryname. The

difference between the interpretation of the lowercase

r versus the uppercase R is in

the treatment of non-unique entry speciﬁcations. Normally the NIS+ server will disal-

low an attempt to remove an entry when the search criterion speciﬁed for that entry

resolves to more than one entry in the table. However, it is sometimes desirable to

remove more than one entry, as when you are attempting to remove all of the entries

from a table. In this case, using the uppercase

R will force the NIS+ server to remove

all entries matching the passed search criterion. If that criterion is null and no

column values speciﬁed, then all entries in the table will be removed.

-u Update attributes of a table. This allows the concatenation path (

-p), separation

character (speciﬁed with the (

-s)), column access rights, and table type string (

-t)of

a table to be changed. Neither the number of columns, nor the columns that are

searchable may be changed.

-D defaults When creating objects, this option speciﬁes a different set of defaults to be used during

this operation. The defaults string is a series of tokens separated by colons. These

tokens represent the default values to be used for the generic object properties. All of

the legal tokens are described below.

ttl=time

This token sets the default time to live for objects that are created by this

command. The value time is speciﬁed in the format as deﬁned by the

nischttl(1) command. The default value is 12 hours.

owner=ownername

This token speciﬁes that the NIS+ principal ownername should own the

created object. Normally this value is the same as the principal who is exe-

cuting the command.

group=groupname

This token speciﬁes that the group groupname should be the group owner

for the object that is created. The default value is NULL.

access=rights

This token speciﬁes the set of access rights to be granted for the given

object. The value rights is speciﬁed in the format as deﬁned by the nisch-

mod(1) command. The default value is ----rmcdr- - -r- - -.

-p path When creating or updating a table, this option speciﬁes the table’s search path. When

an nis_list() function is invoked, the user can specify the ﬂag FOLLOW_PATH to

tell the client library to continue searching tables in the table’s path if the search cri-

teria used does not yield any entries. The path consists of an ordered list of table

Section 1−−642 Hewlett-Packard Company − 2 − HP-UX 11i Version 1: September 2005