AT&T UNIX™PC Unix System V Users Manual - tenox

LDCLOSE ( 3X ) LDCLOSE ( 3X )
NAME ldclose, ldaclose - close a common object file
SYNOPSIS
#include
#include
#include
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.
SEE ALSO
fclose(3S), ldopen(3X), ldfcn( 4).
- 1 -