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



-------------------------------------------------------------------------------
ldsseek, ldnsseek



PURPOSE

Seeks to an indexed or named 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 ldsseek (ldptr, sectindx)
LDFILE *ldptr;
unsigned short sectindx;

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

DESCRIPTION

The ldsseek subroutine seeks to 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 ldnsseek subroutine seeks to the section specified by
sectname.

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

RELATED INFORMATION

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










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