Reads the archive header of a member of an archive file.
Object File Access Routine Library (libld.a)
#include <stdio.h> #include <ar.h> #include <ldfcn.h> int ldahread(ldPointer, ArchiveHeader) LDFILE *ldPointer; ARCHDR *ArchiveHeader;
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.
| 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. |
The ldahread subroutine returns a SUCCESS or FAILURE value.
The ldahread routine fails if the TYPE(ldPointer) macro does not represent an archive file, or if it cannot read the archive header.
This subroutine is part of Base Operating System (BOS) Runtime.
The ldfhread subroutine, ldgetname subroutine, ldlread, ldlinit, or ldlitem subroutine, ldshread or ldnshread subroutine, ldtbread subroutine.
Subroutines Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.