Name

dce_cf_profile_entry_from_host - Returns the host profile entry

Synopsis

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

Parameters

Input

hostnameSpecifies the 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

prof_nameThe profile entry 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_profile_entry_from_host() routine returns the profile entry string associated with the hostname passed to it.  If hostname is NULL, the profile entry associated with the name returned by dce_cf_get_host_name() is returned. 

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), dce_cf_prin_name_from_host(3dce). 

Books: OSF DCE Administration Guide.