NAME

SYNOPSIS

#include <dce/dce_cf.h>

void dce_cf_get_cell_name(
        char **cellname,
        error_status_t *status);

PARAMETERS

Input

None.

Output

cellname

The address of a string pointer. This pointer will be set by the function to point to an allocated buffer that contains the cellname.

Output

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

dce_cf_e_file_open

dce_cf_e_no_mem

dce_cf_e_no_match

DESCRIPTION

The dce_cf_get_cell_name() routine retrieves the primary name for the local cell. If the name is found, dce_cf_get_cell_name() returns an allocated (by a call to malloc()) copy of it in the cellname input parameter. Use free() to free the allocated copy when you no longer need it.

The DCE 1.0 version of this routine is limited to processing lines of text whose length is less than 1024 characters.

RETURN VALUES

No value is returned.

RELATED INFORMATION

Functions: dce_cf_free_cell_aliases(3dce), dce_cf_get_cell_aliases(3dce), dce_cf_get_host_name(3dce), dce_cf_prin_name_from_host(3dce).

Books: Transarc DCE Administration Guide.