XLATE_FINISH(3E)					      XLATE_FINISH(3E)

NAME    [Toc]    [Back]

     xlate_finish - close translation section

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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    [Toc]    [Back]

     /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    [Toc]    [Back]

     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 ALSO    [Toc]    [Back]

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


									PPPPaaaaggggeeee 2222