dce_cf_get_cell_name(3dce)
Returns the primary name for the local cell
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.
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.
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_prin_name_from_host(3dce)
Book: OSF DCE Administration Guide - Core Components