OSF DCE Application Development Guide--Core Components

OSF DCE Application Development Guide—Core Components
an integer.
For example, the following leaf names distinguish two instances of a calendar
service on the JULES system:
calendar_JULES_01
calendar_JULES_02
Avoid automatically generating entry names for the server entries of server
instances; for example, by using unique data such as a timestamp
(calendar_verne_15OCT91_21:25:32) or a process identifier
(calendar_jules_208004D6). When a server incorporates such unique data into its
server entry names, each server instance creates a separate server entry, causing
many server entries. When a server instance stops running, it leaves an obsolete
server entry that is not reused. The creation of a new entry whenever a server
instance starts may impair performance.
A server can use multiple server entries to advertise different combinations of
interfaces and objects. For example, a server can create a separate server entry for a
specific object, and the associated interfaces. The name of such a server entry
should correspond to a well-known name for the object. For example, consider a
server that offers a horticulture bulletin board known to users as horticulture_bb.
The server exports the horticulture_bb object, binding information, and the
associated bulletin-board interface to a server entry whose leaf name identifies the
object, as follows:
horticulture_bb
Note: An RPC server that uses RPC authentication can choose identical
names for its principal name and its server entry. Use of identical
names permits a client that calls the rpc_binding_set_auth_info()
routine to automatically determine a server’s principal name. (The
client will assume the principal name to be the same as the server’s
entry name.) If a server uses different principal and server entry
names, users must explicitly supply the principal name. For an
explanation of principal names, see Part 5 of this guide.
• Naming a group
The leaf name of a group should indicate the interface, service, or object that
determines membership in the group. For example, for a group whose members are
selected because they advertise an interface named Statistics, the following is an
effective leaf name:
Statistics
For a group whose members advertise laser printer print queues as objects, the
following is an effective leaf name:
laser-printer
14 − 24 Tandem Computers Incorporated 124245