ldclose(3)                          CLIX                          ldclose(3)



  NAME

    ldclose, ldaclose - Closes 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 ldclose(
      LDFILE *ldptr );

    int ldaclose(
      LDFILE *ldptr );

  PARAMETERS

    ldptr   A pointer to LDFILE structure.

  DESCRIPTION

    The functions ldopen() and ldclose() are designed to provide uniform
    access to both simple object files and object files that are members of
    archive files.  Thus an archive of common object files can be processed as
    if it were a series of simple common object files.

    If TYPE (ldptr) does not represent an archive file, ldclose() closes the
    file and frees the memory allocated to the LDFILE structure associated
    with ldptr.  If TYPE(ldptr) is the magic number of an archive file, and if
    there are any more files in the archive, ldclose() will reinitialize
    OFFSET(ldptr) to the file address of the next archive member and return
    FAILURE.  The LDFILE ldopen().  In all other cases, ldclose() returns
    SUCCESS.

    The ldaclose() function closes the file and frees the memory allocated to
    the LDFILE structure associated with ldptr regardless of the value of
    TYPE(ldptr).  The ldaclose() always returns SUCCESS.  The function is
    often used in conjunction with ldaopen().

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



  2/94 - Intergraph Corporation                                              1

  ldclose(3)                          CLIX                          ldclose(3)



    libld.a.

    INCDIR is the standard directory list for #include files, usually
    /usr/include.  LIBDIR is the set of standard library files, usually /lib.

  RELATED INFORMATION

    Functions:  fclose(3), ldopen(3)

    Files:  ldfcn(0)












































  2                                              Intergraph Corporation - 2/94