Name

dce_cf_prin_name_from_host - Returns the host’s principal name

Synopsis

#include <stdio.h>
#include <dce/dce_cf.h> void dce_cf_prin_name_from_host(
char ∗hostname,
char ∗∗prin_name,
error_status_t ∗status);

Parameters

Input

hostnameThe name of the host.  Note that host names are case sensitive.  If NULL, the configuration file is searched for the host name, and that name, if found, is used. 

Output

prin_nameThe principal name associated with the specified host. 

statusReturns 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), dce_cf_find_name_by_key(3dce), dce_cf_get_cell_name(3dce), dce_cf_get_host_name(3dce). 

Books: OSF DCE Administration Guide.