Name

dce_cf_free_cell_aliases - Frees a list of cell name aliases for the local cell

Synopsis

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

Parameters

Input

cell_alias_list
The address of a cell alias list, which is a null-terminated array of pointers to the cell alias names for the local cell.

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_free_cell_aliases() routine frees the list of aliases for the local cell that the dce_cf_free_cell_aliases() routine allocated.  The routine frees the memory allocated to hold the array of pointers to cell alias string buffers, and also frees the string buffers. 

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_get_cell_aliases(3dce), dce_cf_get_cell_name(3dce), dce_cf_get_host_name(3dce), dce_cf_prin_name_from_host(3dce), dce_cf_same_cell_name(3dce). 

Books: OSF DCE Application Development Guide—Core Components, OSF DCE Command Reference.