LDRSEEK(3x,L)               AIX Technical Reference               LDRSEEK(3x,L)



-------------------------------------------------------------------------------
ldrseek, ldnrseek



PURPOSE

Seeks to relocation entries of a section of a common object file.

LIBRARY

Object File Access Routine Library (libld.a)

SYNTAX

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

int ldrseek (ldptr, sectindx)
LDFILE *ldptr;
unsigned short sectindx;

int ldnrseek (ldptr, sectname)
LDFILE *ldptr;
char *sectname;

DESCRIPTION

The ldrseek subroutine seeks to the relocation entries of the section specified
by sectindx of the common object file currently associated with ldptr.  Note
that the first section has an index of 1.  The ldnrseek subroutine seeks to the
relocation entries of the section specified by sectname.

The ldrseek and ldnrseek subroutines return SUCCESS or FAILURE.  The ldrseek
subroutine fails if sectindx is greater than the number of sections in the
object file.  The ldnrseek subroutine fails if there is no section name
corresponding with *sectname.  Either function fails if the specified section
has no relocation entries or if it cannot seek to the specified relocation
entries.

RELATED INFORMATION

In this book:  "ldclose, ldaclose," "ldfcn," "ldopen, ldaopen," and "ldshread,
ldnshread."









Processed November 7, 1990       LDRSEEK(3x,L)                                1