ldshread(3)                         CLIX                         ldshread(3)



  NAME

    ldshread, ldnshread - Reads an indexed/named section header of a common
    object file

  LIBRARY

    COFF Object File Manipulation Library (libld.a)

  SYNOPSIS

    #include <stdio.h>

    #include <filehdr.h>

    #include <scnhdr.h>

    #include <ldfcn.h>

    int ldshread(
      LDFILE ldptr ,
      unsigned short sectindx ,
      SCNHDR secthead );

    int ldnshread(
      LDFILE ldptr ,
      char sectname ,
      SCNHDR secthead );

  DESCRIPTION

    The ldshread() reads the section header specified by sectindx of the
    common object file currently associated with ldptr into the area of memory
    beginning at secthead.

    The ldnshread() reads the section header specified by sectname into the
    area of memory beginning at secthead.

    The ldshread() and ldnshread() return SUCCESS or FAILURE.  The ldshread()
    function will fail if sectindx is greater than the number of sections in
    the object file; The ldnshread() function will fail if there is no section
    name corresponding with sectname.  Either function will fail if it cannot
    read the specified section header.

    Note that the first section header has an index of one.

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

    The intro(3) describes INCDIR and LIBDIR.




  2/94 - Intergraph Corporation                                              1

  ldshread(3)                         CLIX                         ldshread(3)



  RELATED INFORMATION

    Functions: ldclose(3), ldopen(3),

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

















































  2                                              Intergraph Corporation - 2/94