ldclose(3) Library Functions Manual ldclose(3)NAME
ldclose, ldaclose - close a common object file
SYNOPSIS
#include <stdio.h>
#include <filehdr.h>
#include <syms.h>
#include <ldfcn.h>
int ldclose (ldptr)
LDFILE *ldptr;
int ldaclose (ldptr)
LDFILE *ldptr;
DESCRIPTION ldopen(3) and ldclose provide uniform access to simple object files and object files that are members of archive files. An archive of com-
mon 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 associ-
ated 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(3). 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 with ldaopen.
The program must be loaded with the object file access routine library
libmld.a.
RELATED INFORMATION fclose(3), ldopen(3), ldfcn(4). delim off
ldclose(3)
Check Out this Related Man Page
ldopen(3x)ldopen(3x)Name
ldopen, ldaopen, ldreadst - open a common object file for reading
Syntax
#include <stdio.h>
#include <filehdr.h>
#include <syms.h>
#include <ldfcn.h>
LDFILE *ldopen (filename, ldptr)
char *filename;
LDFILE *ldptr;
LDFILE *ldaopen (filename, oldptr)
char *filename;
LDFILE *oldptr;
ldreadst (ldptr, flags)
LDFILE *ldptr;
intflags;
Description
The and functions provide uniform access to simple object files and to object files that are members of archive files. An archive of com-
mon object files can be processed as if it is a series of simple common object files.
If ldptr has the value null, opens filename, allocates and initializes the LDFILE structure, and returns a pointer to the structure to the
calling program.
If ldptr is valid and TYPE(ldptr) is the archive magic number, reinitializes the LDFILE structure for the next archive member of filename.
The and functions work in concert. The function returns failure only when only when TYPE(ldptr) is the archive magic number and there is
another file in the archive to be processed. Only then should be called with the current value of ldptr. In all other cases, but espe-
cially when a new filename is opened, should be called with a null ldptr argument.
The following is a prototype for the use of and
/* for each filename to be processed*/
ldptr = NULL;
do
if ( (ldptr = ldopen(filename, ldptr)) != NULL )
{
/* check magic number */
/* process the file */
}
} while (ldclose(ldptr) == FAILURE );
If the value of oldptr is not NULL, opens filename anew and allocates and initializes a new LDFILE structure, copying the fields from
oldptr. The function returns a pointer to the new LDFILE structure. This new pointer is independent of the old pointer, oldptr. The two
pointers can be used concurrently to read separate parts of the object file. For example, one pointer can be used to step sequentially
through the relocation information while the other is used to read indexed symbol table entries.
The and functions open filename for reading. If filename cannot be opened or if memory for the LDFILE structure cannot be allocated, both
functions return NULL. A successful open does not ensure that the given file is a common object file or an archived object file.
The function causes the symbol table header and file descriptor table to be read. Further access, using ldptr, causes other appropriate
sections of the symbol table to be read (for example, if you call the symbols or externals are read). To force sections for each symbol
table in memory, call with ST_P* constants or'ed together from st_support.h.
See Alsofopen(3s), ldclose(3x), ldfcn(5)
RISC ldopen(3x)