LDCLOSE(3X)                          SysV                          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 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 routine library
     libld.a.

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