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 ac-
          cess 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 com-
          mon 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 mag-
          ic 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.

          Programs using this routine must be loaded with the object
          file access library libld.a.

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















     April, 1990                                                     1