dce_cf_binding_entry_from_host(3dce)
Returns the host binding entry name
Synopsis
#include <dce/dce_cf.h>
void dce_cf_binding_entry_from_host(
char *hostname,
char **entry_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
entry_name
The binding entry 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_binding_entry_from_host( ) routine returns the binding entry name string associated with the hostname passed to it. If
hostname is NULL, the binding entry name 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)
Book: OSF DCE Administration Guide - Core Components