dce_cf_prin_name_from_host(3dce)
Returns the host's principal name
Synopsis
#include <dce/dce_cf.h>
void dce_cf_prin_name_from_host(
char *hostname,
char **prin_name,
error_status_t *status);
Parameters
Input
hostname
The name of the host. Note that host names are case sensitive. If NULL, the configuration file is searched for the hostname, and that name, if found, is used.
Output
prin_name
The principal name associated with the specified host.
status
Returns the status code from this operation. The status code is a value that indicates whether the routine completed successfully and if not, why not.
Description
The dce_cf_prin_name_from_host( ) routine returns the principal name associated with the hostname passed to it. If hostname is
NULL, dce_cf_prin_name_from_host( ) returns the principal name associated with the name returned by dce_cf_get_host_name( ).
Files
dcelocal/dce_cf.db
The machine's local DCE configuration file (where dcelocal is usually something like /opt/dcelocal).
Errors
The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.
dce_cf_st_ok
Operation completed successfully.
dce_cf_e_file_open
File open error.
dce_cf_e_no_mem
No memory available.
dce_cf_e_no_match
No host name entry in the DCE configuration file.
Related Information
Functions: dce_cf_binding_entry_from_host(3dce)
Book: OSF DCE Administration Guide - Core Components