LDCLOSE(3X)

NAME
ldclose, ldaclose - close a COFF file

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

int ldclose (ldptr)
LDFILE *ldptr;

int ldaclose (ldptr)
LDFILE *ldptr;

AVAILABILITY

Available only on Sun 386i systems running a SunOS 4.0.x release or earlier. Not a SunOS 4.1 release feature.

DESCRIPTION

ldopen(3X) and ldclose() are designed to provide uniform access to both simple COFF object files and COFF object files that are members of archive files. Thus an archive of COFF files can be processed as if it were a series of simple COFF 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.

intro(5) describes INCDIR and LIBDIR.

SEE ALSO
fclose(3V), ldfcn(3), ldopen(3X), intro(5)