NAME
      dce_cf_get_cell_name - 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.
               Possible status codes and their meanings are as follows:

               dce_cf_st_ok            Operation completed succesfully.

               dce_cf_e_file_open      File open error.

               dce_cf_e_no_mem         No memory available.

               dce_cf_e_no_match       No match for key in the file.

  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
                 dce_cf_get_cell_aliases
                 dce_cf_get_host_name
                 dce_cf_prin_name_from_host

      BOOKS: OSF DCE Administration Guide.