ldclose(3x)                DG/UX 4.30                 ldclose(3x)



     NAME
          ldclose, ldaclose - close an 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
          object files and 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 re-initialize
          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)         Page 1