ldahread(3)                         CLIX                         ldahread(3)



  NAME

    ldahread - Reads the archive header of a member of an archive file

  LIBRARY

    COFF Object File Manipulation Library (libld.a)

  SYNOPSIS

    #include <stdio.h>

    #include <ar.h>

    #include <filehdr.h>

    #include <ldfcn.h>

    #include "INCDIR/filehdr.h"

    #include "INCDIR/ldfcn.h"

    int ldahread(
      LDFILE *ldptr ,
      ARCHDR *arhead );

  DESCRIPTION

    If TYPE(ldptr) is the archive file magic number, ldahread() reads the
    archive header of the common object file (currently associated with ldptr)
    into the area of memory beginning at arhead.

    The program must be loaded with the object file access function library
    libld.a.

    INCDIR is the standard directory list for #include files, usually
    /usr/include.  LIBDIR is the set of standard library files, usually /lib.

  RETURN VALUES

    The ldahread() function returns SUCCESS or FAILURE.  The ldahread() will
    fail if TYPE(ldptr) does not represent an archive file, or if it cannot
    read the archive header.

  RELATED INFORMATION

    Functions:  ldclose(3), ldopen(3)

    Files:  ldfcn(4), path.h(4), ar(4)





  2/94 - Intergraph Corporation                                              1