dce_cf_intro(3dce)
Introduction to the DCE configuration routines
Description
The DCE configuration routines return information based on the contents of the local DCE configuration file, which is created during the DCE cell-configuration or
machine-configuration process. A configuration file is located on each DCE machine; it contains the host's name, the primary name of the cell in which the host is located, and any aliases for that
cell name.
The configuration routines can also be used to get some additional information corollary to the hostname, namely:
· The host's principal name.
· Binding information to the host.
The configuration file on machines that belong to internationalized DCE cells also contains the path name to the code set registry object file on the host.
The Security Service component on each DCE machine must be able to find out, by strictly local means, its machine's hostname, the host machine's principal name, and its cell's name. The DCE configuration routines exist primarily to enable Security components to do these things. But because this information can be useful to DCE applications as well, these routines are made available as part of the general application programming interface.
Note that hostname as used throughout this section refers to the DCE hostname (that is, the machine's /.../cellname/host_directory/hostname entry in the CDS namespace), and not, for example, its DNS (Domain Name Service) hostname, which could be quite different from the DCE name.
The DCE configuration routines are:
dce_cf_binding_entry_from_host( )
Returns the host binding entry name.
dce_cf_dced_entry_from_host( )
Returns the dced entry name on a host.
dce_cf_find_name_by_key( )
Returns a string tagged by key (this is a lower-level utility routine that is used by the others).
dce_cf_free_cell_aliases( )
Frees a list of cell aliases for a cell.
dce_cf_get_cell_aliases( )
Returns a list of cell aliases for a cell.
dce_cf_get_cell_name( )
Returns the primary cell name for the local cell.
dce_cf_get_csrgy_filename( )
Returns the path name of the local code set registry object file.
dce_cf_get_host_name( )
Returns the hostname relative to a local cell.
dce_cf_prin_name_from_host( )
Returns the host's principal name.
dce_cf_profile_entry_from_host
Returns the host's profile entry.
dce_cf_same_cell_name( )
Indicates whether or not two cell names refer to the same cell.
More: