LDCLOSE(3X)          INTERACTIVE UNIX System          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
               The ldopen(3X) and ldclose functions are designed to provide
               uniform access to both simple object files and object files
               that are members of archive files.  Thus an archive of com-
               mon 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
               will close the file and free 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 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 rou-
               tine library libld.a.

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













          Rev. C Software Development Set                            Page 1