ldlseek or ldnlseek Subroutine

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

ldlseek or ldnlseek Subroutine

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 <ldfcn.h>

int ldlseek (ldPointer, SectionIndex)
LDFILE *ldPointer;
unsigned short SectionIndex;
 
int ldnlseek (ldPointer, SectionName)
LDFILE *ldPointer;
char *SectionName;

Description

The ldlseek subroutine seeks to the line number entries of the section specified by the SectionIndex parameter of the common object file currently associated with the ldPointer parameter. The first section has an index of 1.

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

Both subroutines determine the object mode of the associated file before seeking to the relocation entries of the indicated section.

Parameters

ldPointer	Points to the LDFILE structure that was returned as the result of a successful call to the ldopen or ldaopen subroutine.
SectionIndex	Specifies the index of the section whose line number entries are to be seeked to.
SectionName	Specifies the name of the section whose line number entries are to be seeked to.

Return Values

The ldlseek and ldnlseek subroutines return a SUCCESS or FAILURE value.

Error Codes

The ldlseek subroutine fails if the SectionIndex parameter is greater than the number of sections in the object file. The ldnlseek subroutine fails if there is no section name corresponding with the SectionName parameter. Either function fails if the specified section has no line number entries or if it cannot seek to the specified line number entries.

Implementation Specifics

These subroutines are part of Base Operating System (BOS) Runtime.

Related Information

The ldohseek subroutine, ldrseek or ldnrseek subroutine, ldsseek or ldnsseek subroutine, ldtbseek subroutine.

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