ldlseek(3)                          CLIX                          ldlseek(3)



  NAME

    ldlseek, ldnlseek - Seeks to line number entries of a section 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 ldlseek(
      LDFILE *ldptr ,
      unsigned short sectindx );

    int ldnlseek(
      LDFILE *ldptr ,
      char *sectname );

  DESCRIPTION

    The ldlseek() function seeks to the line number entries of the section
    specified by sectindx of the common object file currently associated with
    ldptr.

    The ldnlseek() function seeks to the line number entries of the section
    specified by sectname.

    Note that the first section has an index of one.

    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 functions ldlseek() and ldnlseek() return SUCCESS or FAILURE.  The
    ldlseek() function fails if sectindx is greater than the number of
    sections in the object file.  The ldnlseek() function fails if there is no



  2/94 - Intergraph Corporation                                              1

  ldlseek(3)                          CLIX                          ldlseek(3)



    section name corresponding with sectname.  Either function will fail if
    the specified section has no line number entries or if it cannot seek to
    the specified line number entries.

  RELATED INFORMATION

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

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













































  2                                              Intergraph Corporation - 2/94