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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

nistbladm(1) nistbladm(1)

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 pos-

sible 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 disallow 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 dur-

ing 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 proper-

ties. 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

executing 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

nischmod(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 criteria used does not yield any entries. The path consists of an

ordered list of table names, separated by colons. The names in the path must be

HP-UX 11i Version 2: September 2004 − 2 − Hewlett-Packard Company Section 1−−667