PreviousNext

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_get_cell_aliases(3dce)

dce_cf_get_host_name(3dce)

dce_cf_prin_name_from_host(3dce)

Book: OSF DCE Administration Guide - Core Components