ldrseek or ldnrseek Subroutine

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

ldrseek or ldnrseek Subroutine

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>
 
int ldrseek (ldPointer, SectionIndex)
ldfile *ldPointer;
unsigned short SectionIndex;
 
int ldnrseek (ldPointer, SectionName)
ldfile *ldPointer;
char *SectionName;

Description

The ldrseek subroutine seeks to the relocation entries of the section specified by the SectionIndex parameter of the common object file currently associated with the ldPointer parameter.

The ldnrseek subroutine seeks to the relocation entries of 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 subroutines.
SectionIndex	Specifies an index of the section whose relocation entries are to be seeked to.
SectionName	Specifies the name of the section whose relocation entries are to be seeked to.

Return Values

The ldrseek and ldnrseek subroutines return a success or failure value.

Error Codes

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

Note: The first section has an index of 1.

Implementation Specifics

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

Related Information

The ldohseek subroutine, ldlseek or ldnlseek subroutine, ldsseek or ldnsseek subroutine, ldtbseek subroutine.

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