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



-------------------------------------------------------------------------------
ldshread, ldnshread



PURPOSE

Reads an indexed or named section header of a common object file.

LIBRARY

Object File Access Routine Library (libld.a)

SYNTAX

#include <stdio.h>
#include <filehdr.h>
#include <scnhdr.h>
#include <ldfcn.h>

int ldshread (ldptr, sectindx, secthead)
LDFILE *ldptr;
unsigned short sectindx;
SCNHDR *secthead;

int ldnshread (ldptr, sectname, secthead)
LDFILE *ldptr;
char *sectname;
SCNHDR *secthead;

DESCRIPTION

The ldshread subroutine reads the section header specified by sectindx of the
common object file currently associated with ldptr into the area of memory
beginning at secthead.  Note that the first section has an index of 1.  The
ldnshread subroutine reads the section header specified by sectname into the
area of memory beginning at secthead.

The ldshread and ldnshread subroutines return SUCCESS or FAILURE.  The ldshread
subroutine fails if sectindx is greater than the number of sections in the
object file.  The ldnshread subroutine fails if there is no section name
corresponding with sectname.  Either function fails if it cannot read the
specified section header.

RELATED INFORMATION

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








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