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.