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 com-
     mon 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).













Page 1                        CX/UX Programmer's Reference Manual