ldfhread(3X)                                         ldfhread(3X)



     NAME
          ldfhread - read the file header of a common object file

     SYNOPSIS
          #include <stdio.h>
          #include <filehdr.h>
          #include <ldfcn.h>

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

     DESCRIPTION
          ldfhread reads the file header of the common object file
          currently associated with ldptr into the area of memory be-
          ginning at filehead.

          ldfhread returns SUCCESS or FAILURE.  ldfhread fails if it
          cannot read the file header.

          In most cases the use of ldfhread can be avoided by using
          the macro HEADER(ldptr) defined in <ldfcn.h> (see ldfcn(3)).
          The information in any field of the file header may be ac-
          cessed by applying the dot operator to the value returned by
          the HEADER macro; for example:

             HEADER(ldptr).f_timdat


          The program using this routine must be loaded with the ob-
          ject file access library libld.a.

     SEE ALSO
          ldclose(3X), ldfcn(3X), ldopen(3X), filehdr(4).





















     April, 1990                                                     1