ldclose(3X)                    DG/UX R4.11MU05                   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 provide uniform access to both simple common
       object (COFF) files and common object files that are members of
       archive files.  Thus an archive of object files can be processed as
       if it were a series of simple 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.  Ldaclose is often
       used in conjunction with ldaopen(3X).

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

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


Licensed material--property of copyright holder(s)