Name

dce_cf_get_cell_name - Returns the primary name for the local cell

Synopsis

#include <stdio.h>
#include <dce/dce_cf.h> void dce_cf_get_cell_name(
char ∗∗cellname,
error_status_t ∗status);

Parameters

Input

None. 

Output

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

Output

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

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

dce_cf_e_file_open

dce_cf_e_no_mem

dce_cf_e_no_match

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