ldtbread Subroutine

AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 1

ldtbread Subroutine

Purpose

Reads an indexed symbol table entry of a common object file.

Library

Object File Access Routine Library (libld.a)

Syntax

#include <stdio.h>
#include <filehdr.h>
#include <syms.h>
#include <ldfcn.h>

int ldtbread (ldPointer, SymbolIndex, Symbol)
LDFILE *ldPointer;
long SymbolIndex;
SYMENT *Symbol;

Description

The ldtbread subroutine reads the symbol table entry specified by the SymbolIndex parameter of the common object file currently associated with the ldPointer parameter into the area of memory beginning at the Symbol parameter.

Parameters

ldPointer	Points to the LDFILE structure that was returned as the result of a successful call to the ldopen or ldaopen subroutine.
SymbolIndex	Specifies the index of the symbol table entry to be read.
Symbol	Points to a SYMENT structure.

Return Values

The ldtbread subroutine returns a success or failure value.

Error Codes

The ldtbread subroutine fails if the SymbolIndex parameter is greater than or equal to the number of symbols in the object file, or if it cannot read the specified symbol table entry.

Note: The first symbol in the symbol table has an index of 0.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The ldahread subroutine, ldfhread subroutine, ldgetname subroutine, ldlread, ldlinit, or ldlitem subroutine, ldshread or ldnshread subroutine.

Subroutines Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.