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.

Possible status codes and their meanings are as follows:

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.

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).

RETURN VALUES

No value is returned.

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: Transarc DCE Administration Guide.