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



-------------------------------------------------------------------------------
ldlseek, ldnlseek



PURPOSE

Seeks to line number 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 ldlseek (ldptr, sectindx)
LDFILE *ldptr;
unsigned short sectindx;

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

DESCRIPTION

The ldlseek subroutine seeks to the line number entries of the section
specified by sectindx of the common object file currently associated with
ldptr.

The ldnlseek subroutine seeks to the line number entries of the section
specified by sectname.

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

Note that the first section has an index of 1.

RELATED INFORMATION

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






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