xlate_pro_finish(3E)

NAME
     xlate_pro_finish - Closes translation handle

SYNOPSIS
     #include <elf.h>
     #include <libelf.h>
     #include <dwarf.h>
     #include <libdwarf.h>
     #include <cmplrs/xlate.h>
     #include <libXlate.h>

     int xlate_pro_finish(xlate_table_pro producer_table_ptr);

DESCRIPTION
     The xlate_pro_finish function is used to close a handle on translation
     information data.  It accepts the following argument:

     producer_table_ptr  Specifies a valid open xlate producer handle.

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

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_TB_STATUS_NO_ERROR (0) is returned 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).

     XLATE_TB_STATUS_INVALID_TABLE:  table is not a valid open producer
     handle.

SEE ALSO
     xlate_init_fd(3e), xlate_pro_init(3e)

     xlate(4)

     libelfutil(5)