PreviousNext

add entry(8rpc)

Adds a name service entry to the name service database

Synopsis

rpccp add entry entry-name [-s syntax]

Options

-s syntax
Indicates the name syntax of the entry name (optional). The only value for this option is the dce name syntax, which is the default name syntax. Until an alternative name syntax becomes available, specifying the -s option is unnecessary.

Arguments

entry-name
Specifies the name of the target name service entry. For an entry in the local cell, you can omit the cell name and specify only the cell-relative name.

Description
The add entry command adds an unspecialized entry to the name service database. The name of the entry is required.

The new entry initially contains no NSI attributes. This command creates a general name service entry for an application or user. The application or user can later use the export, add element, and add member commands to make the generic entry into a server entry, a group, or a profile (or a combination), as follows:

· For a server entry, specify the new entry as the target entry for the rpccp export command.

· For a group, specify the new entry as the target group for the rpccp add member command.

· For a profile, specify the new entry as the target profile for the rpccp add element command.

The add entry command enables administrators to add entries for users who lack the required permissions. If you have the permissions required by the add entry command, you can also add an entry using an export, add member, or add element command; if the entry you specify does not exist, the command creates the entry.

Privileges Required
To add an entry, you need insert permission to the parent directory and both read permission and write permission to the CDS object entry (the target name service entry).

Notes
This command is replaced at Revision 1.1 by the dcecp command and may not be provided in future releases of DCE.

Examples
The following commands start the RPC control program (rpccp) and add an unspecialized entry to the name service database:

rpccp> add entry \
> /.:/LandS/anthro/Cal_host_2

The following command operates from the system prompt to add an unspecialized entry to the name service database:

rpccp add entry \
> /.:/LandS/anthro/Cal_host_3

Related Information
Commands:

remove entry(8rpc)

show entry(8rpc)