ldclose(3X)                                           ldclose(3X)



     NAME
          ldclose, ldaclose - close a common object file

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


          int ldclose (ldptr)
          LDFILE *ldptr;

          int ldaclose (ldptr)
          LDFILE *ldptr;

     DESCRIPTION
          ldopen(3X) 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 reinitializes OFFSET(ldptr) to
          the file address of the next archive member and returns
          FAILURE.  The LDFILE structure is prepared for a subsequent
          ldopen(3X).  In all other cases, ldclose returns SUCCESS.

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

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

     SEE ALSO
          fclose(3S), ldopen(3X), ldfcn(4).














     Page 1                                        (last mod. 1/14/87)