XLATE_FINISH(3E)XLATE_FINISH(3E)NAMExlate_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.
Page 1
XLATE_FINISH(3E)XLATE_FINISH(3E)SEE ALSOlibelfutil(5), xlate(4), xlate_init_fd(3e), xlate_init_elf(3e),
xlate_pro_init(3e), xlate_pro_finish(3e), xlate_address(3e)
Page 2
