[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 1

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

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.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

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.


[ Previous | Next | Contents | Glossary | Home | Search ]