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



-------------------------------------------------------------------------------
ldfhread



PURPOSE

Reads the file header of a common object file.

LIBRARY

Object File Access Routine Library (libld.a)

SYNTAX

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

int ldfhread (ldptr, filehead)
LDFILE *ldptr;
FILHDR *filehead;

DESCRIPTION

The ldfhread subroutine reads the file header of the common object file
currently associated with ldptr into the area of memory beginning at filehead.

The ldfhread subroutine returns SUCCESS or FAILURE.  The ldfhread subroutine
fails if it cannot read the file header.

In most cases, the use of ldfhread can be avoided by using the macro
HEADER(ldptr) defined in ldfcn.h (see "ldfcn").  The information in any field,
fieldname, of the file header may be accessed using HEADER(ldptr).fieldname.

RELATED INFORMATION

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

















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