xlate_finish(3E)

NAME
     xlate_finish - close translation section

SYNOPSIS
     #include <elf.h>
     #include <libelf.h>
     #include <dwarf.h>
     #include <libdwarf.h>
     #include <cmplrs/xlate.h>
     #include <libXlate.h>
     int xlate_finish(xlate_table_con consumer_table_ptr);

DESCRIPTION
     This is used to close a handle on an Elf section containing translation
     information.  consumer_table_ptr must be a valid open handle on an xlate
     consumer section.

     This releases all memory allocated by the xlate functions for this
     xlate_table_con (except as documented in calls that certain things must
     be free(3)d explicitly by the application).

FILES
     /usr/include/libXlate.h
     /usr/include/cmplrs/xlate.h
     /usr/include/elf.h
     /usr/include/dwarf.h
     /usr/include/libdwarf.h
     /usr/lib/libelfutil.a

DIAGNOSTICS
     Returns XLATE_TB_STATUS_NO_ERROR (0) on success.  In case of error, a
     negative number is returned indicating the error.  In case of error,
     nothing is returned thru the pointer arguments which would return values
     on successful call (values might have been changed thru these pointers
     but any such changes are not meaningful).

     XLATE_TB_STATUS_NULL_TABLE
             means that a NULL (0) pointer was passed as the
             consumer_table_ptr.  This is unwise since most of the translation
             library calls will simply coredump when passed a NULL
             consumer_table_ptr.

     XLATE_TB_STATUS_INVALID_TABLE
             The initial bytes of the structure pointed to by
             consumer_table_ptr have been corrupted (indicating malloc(3)
             arena corruption) or the pointer is not pointing to a valid open
             consumer table.  This error can be caused by, for example,
             calling xlate_finish twice on the same consumer_table_ptr.
SEE ALSO
     libelfutil(5), xlate(4), xlate_init_fd(3e), xlate_init_elf(3e),
     xlate_pro_init(3e), xlate_pro_finish(3e), xlate_address(3e)