LDCLOSE(3X) (Specialized Libraries) 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.
Page 1 May 1989
LDCLOSE(3X) (Specialized Libraries) LDCLOSE(3X)
SEE ALSO
fclose(3S), ldopen(3X), ldfcn(4).
Page 2 May 1989