Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ ldaclose(3x) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                              ldclose(3x)



        _________________________________________________________________
        ldclose, ldaclose                                      Subroutine
        close an executable file in DG/UX
        _________________________________________________________________


        SYNTAX

        #include <stdio.h>
        #include <sys/types.h>
        #include <filehdr.h>
        #include <ldfcn.h>

        int ldclose (ldptr)
        LDFILE *ldptr;

        int ldaclose (ldptr)
        LDFILE *ldptr;


        DESCRIPTION

        Ldopen(3X) and ldclose are provide uniform access to both simple
        executable files and executable files that are members of archive
        files.  Thus an archive of executable files can be processed as
        if it were a series of simple executable 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 re-initialize 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.  Ldaclose is often
        used in conjunction with ldaopen(3X).

        The program must be loaded with the executable file access
        routine library libld.a.


        SEE ALSO

        fclose(3S), ldopen(3X), ldfcn(4).






        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                              ldclose(3x)



        CAVEATS

        The executable file format is used only for executable files
        (load modules), not for object files.


















































        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026