ldfhread(3)                         CLIX                         ldfhread(3)



  NAME

    ldfhread - Reads the file header of a common object file

  LIBRARY

    COFF Object File Manipulation Library (libld.a)

  SYNOPSIS

    #include <stdio.h>

    #include <filehdr.h>

    #include <ldfcn.h>

    #include "INCDIR/filehdr.h"

    #include "INCDIR/ldfcn.h"

    int ldfhread(
      LDFILE *ldptr ,
      FILHDR *filehead );

  DESCRIPTION

    The ldfhread() function reads the file header of the common object file
    currently associated with ldptr into the area of memory beginning at
    filehead.

    In most cases the use of ldfhread() can be avoided by using the macro
    HEADER(ldptr) defined in ldfcn.h [see ldfcn].  The information in any
    field, fieldname, of the file header may be accessed using HEADER(ldptr).
    fieldname.

    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 ldfhread() function returns SUCCESS or FAILURE.  The ldfhread()
    function will fail if it cannot read the file header.

  RELATED INFORMATION

    Functions:  ldclose(3), ldopen(3)

    Files:  idfcn(4), path.h(4)



  2/94 - Intergraph Corporation                                              1