ldahread Subroutine

Purpose

Reads the archive header of a member of an archive file.

Library

Object File Access Routine Library (libld.a)

Syntax

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

int ldahread(ldPointer,ArchiveHeader)
LDFILE *ldPointer;
ARCHDR *ArchiveHeader;

Description

If the TYPE(ldPointer) macro from the ldfcn.h file is the archive file magic number, the ldahread subroutine reads the archive header of the extended common object file currently associated with the ldPointer parameter into the area of memory beginning at the ArchiveHeader parameter.

Parameters

Item	Description
ldPointer	Points to the LDFILE structure that was returned as the result of a successful call to ldopen or ldaopen.
ArchiveHeader	Points to a ARCHDR structure.

Return Values

The ldahread subroutine returns a SUCCESS or FAILURE value.

Error Codes

The ldahread routine fails if the TYPE(ldPointer) macro does not represent an archive file, or if it cannot read the archive header.