xlate_finish(3E)

NAME
     xlate_finish - Closes 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
     xlate_finish 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 freeed explicitly by the application).

     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.

THREAD SAFETY
     The xlate functions are thread safe.  This means that if distinct
     xlate_table_con and xlate_table_pro handles are used in distinct
     threads to call xlate functions simultaneously in multiple threads,
     the threads will not interfere.

     However, using a particular xlate_table_con handle or a particular
     xlate_table_pro handle to call xlate functions simultaneously in
     multiple threads is not supported and may cause unpredictable results.

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
     xlate_finish 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 through the pointer arguments which
     would return values on successful call (values might have been changed
     through these pointers but any such changes are not meaningful).

SEE ALSO
     xlate_init_fd(3e), xlate_init_elf(3e), xlate_pro_init(3e),
     xlate_pro_finish(3e), xlate_address(3e), xlate(4), libelfutil(5)