XLATE_PRO_NEXT_BLOCK(3E)XLATE_PRO_NEXT_BLOCK(3E)NAMExlate_pro_disk_next_block - get translation byte stream pointers
SYNOPSIS
#include <elf.h>
#include <libelf.h>
#include <dwarf.h>
#include <libdwarf.h>
#include <cmplrs/xlate.h>
#include <libXlate.h>
int xlate_pro_disk_next_block(xlate_table_pro pro_table_ptr,
char **data,
Elf64_Xword *data_size
);
DESCRIPTION
This function gets pointers to the blocks making up the stream of data.
The xlate functions do not write the stream to disk. Typically the
transformation-tool will use libelf to write the bytes to disk.
xlate_pro_disk_next_block gets the contents and size of the next block
thru the pointer arguments.
pro_table_ptr must be a valid open producer translate table handle and
xlate_pro_disk_header must have been called to create the byte stream and
count the number of blocks..
It is essential that if the data stream gets written to a data file (an
Elf file) for later reading that the data stream be given a proper Elf
d_align of 4 for a 32-bit stream and 8 for a 64-bit stream.
data The pointed at memory is set to a pointer to a set of bytes which
form part of the translation table byte stream. The caller must
free(3) the memory pointed-to.
data_size
The pointed at memory is set to the number of bytes in this block
of the byte stream.
For an example of use, see xlate_pro_disk_header(3) and libelfutil(5).
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
Page 1
XLATE_PRO_NEXT_BLOCK(3E)XLATE_PRO_NEXT_BLOCK(3E)DIAGNOSTICS
This function 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.
Error codes which may be returned:
XLATE_TB_STATUS_INVALID_TABLE
means that that the table is not a valid open producer handle.
XLATE_TB_STATUS_BLOCK_REQ_SEQ_ERR
means that xlate_pro_disk_header has not been called yet, and it
must be called before calling xlate_pro_disk_next_block.
XLATE_TB_STATUS_ALREADY_DONE
means that xlate_pro_disk_next_block was called more times than
it should have been since the last call to xlate_pro_disk_header.
XLATE_TB_STATUS_ALLOC_FAIL
means malloc failed trying to allocate memory for the stream
bytes.
SEE ALSOlibelfutil(5), xlate(4), xlate_pro_init(3), xlate_pro_finish(3),
xlate_pro_disk_next_block(3),
Page 2
