Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ldclose(3X)

ldopen(3X)

ldshread(3X)

ldfcn(4)

LDLSEEK(3X)                          BSD                           LDLSEEK(3X)



NAME
     ldlseek, ldnlseek - seek to line number entries of a section of a common
     object file

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

     int ldlseek (ldptr, sectindx)
     LDFILE *ldptr;
     unsigned short sectindx;

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

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

     ldnlseek seeks to the line number entries of the section specified by
     sectname.

     ldlseek and ldnlseek return SUCCESS or FAILURE.  ldlseek will fail if
     sectindx is greater than the number of sections in the object file;
     ldnlseek will fail if there is no 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.

     Note that the first section has an index of one.

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

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

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026