dce_cf_profile_entry_from_host(3dce)
Returns the host profile entry
Synopsis
#include <dce/dce_cf.h>
void dce_cf_profile_entry_from_host(
char *hostname,
char **prof_name,
error_status_t *status);
Parameters
Input
hostname
Specifies 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
prof_name
The profile entry 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_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 hostname entry in the DCE configuration file.
Related Information
Functions: dce_cf_find_name_by_key(3dce)
dce_cf_prin_name_from_host(3dce)
dce_cf_binding_entry_from_host(3dce)
Book: OSF DCE Administration Guide - Core Components