Technical Reference: Base Operating System and Extensions, Volume 1

ldsseek or ldnsseek Subroutine

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

int ldsseek ( ldPointer, SectionIndex) LDFILE *ldPointer; unsigned short SectionIndex;

int ldnsseek (ldPointer, SectionName) LDFILE *ldPointer; char *SectionName;

The ldsseek subroutine seeks to the section specified by the SectionIndex parameter of the common object file currently associated with the ldPointer parameter. The subroutine determines the object mode of the associated file before seeking to the indicated section.

The ldnsseek subroutine seeks to the section specified by the SectionName parameter.

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 ldsseek and ldnsseek subroutines return a SUCCESS or FAILURE value.

Error Codes

The ldsseek subroutine fails if the SectionIndex parameter is greater than the number of sections in the object file. The ldnsseek subroutine fails if there is no section name corresponding with the SectionName parameter. Either function fails if there is no section data for the specified section or if it cannot seek to the specified section.

Note: The first section has an index of 1.

Implementation Specifics

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

Related Information

The ldlseek or ldnlseek (ldlseek or ldnlseek Subroutine) subroutine, ldohseek (ldohseek Subroutine) subroutine, ldrseek or ldnrseek (ldrseek or ldnrseek Subroutine) subroutine, ldtbseek (ldtbseek Subroutine) subroutine.

Subroutines, Example Programs, and Libraries in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.