NAME

ldclose, ldaclose − close a common object file

SYNTAX

#include <stdio.h>
#include <filehdr.h>
#include <syms.h>
#include <ldfcn.h>

int ldclose (ldptr)
LDFILE ∗ldptr;

int ldaclose (ldptr)
LDFILE ∗ldptr;

DESCRIPTION

The ldopen and ldclose functions provide uniform access to simple object files and object files that are members of archive files.  An archive of common object files can be processed as if it is a series of simple common object files. 

If TYPE(ldptr) does not represent an archive file, ldclose closes the file and frees the memory allocated to the LDFILE structure associated with ldptr. If TYPE(ldptr) is the magic number for an archive file and if archive has more files, ldclose reinitializes OFFSET(ldptr) to the file address of the next archive member and returns failure.  The LDFILE structure is prepared for a later ldopen (3x).  In all other cases, ldclose returns success. 

The ldaclose function closes the file and frees the memory allocated to the LDFILE structure associated with ldptr regardless of the value of TYPE(ldptr).  The ldaclose function always returns success.  This function is often used with ldaopen . 

SEE ALSO

fclose(3s), intro(3x) ldopen(3x), ldfcn(5), paths.h(4)

Subroutines