ldfhread(S)                    6 January 1993                    ldfhread(S)


 Name

    ldfhread - read the file header of a common object file

 Syntax


    cc  . . .  -lld


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

    int ldfhread (ldptr, filehead)
    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.

    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(FP)).  The information in any
    field, fieldname, of the file header may be accessed using
    HEADER(ldptr).fieldname.

 See also

    ldfcn(FP), ldahread(S)

 Standards conformance

    ldfhread is not part of any currently supported standard; it is an exten-
    sion of AT&T System V provided by the Santa Cruz Operation.