NAME

add entry - Adds a name service entry to the name service database

SYNOPSIS

rpccp add entry entry-name [-s syntax]

OPTIONS

-s syntaxIndicates 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-nameSpecifies 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 Name Service Interface (NSI) attributes.  This command creates a general name service entry for an application or user.  The application or user can later use the rpccp export, rpccp add element, and rpccp 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 rpccp add entry command, you can also add an entry using an rpccp export, rpccp add member, or rpccp add element command; if the entry you specify does not exist, the command creates the entry. 

Privileges Required

To add an entry, you need i (insert) permission to the parent directory and both r (read) permission and w (write) permission to the Cell Directory Service (CDS) object entry (the target name service entry). 

NOTES

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

EXAMPLES

     1.The following command adds an unspecialized entry to the name service database:

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

     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: rpccp_remove_entry(8rpc), rpccp_show_entry(8rpc).