[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


NAME
    RemLibrary -- remove a library from the system

SYNOPSIS
    RemLibrary(library)
               A1

    void RemLibrary(struct Library *);

FUNCTION
    This function calls the library's EXPUNGE vector, which requests
    that a library delete itself.  The library may refuse to do this if
    it is busy or currently open. This is not typically called by user
    code.

    There are certain, limited circumstances where it may be
    appropriate to attempt to specifically flush a certain Library.
    Example:

     /* Attempts to flush the named library out of memory. */
     #include <exec/types.h>
     #include <exec/execbase.h>

     void FlushLibrary(name)
     STRPTR name;
     {
     struct Library *result;

        Forbid();
        if(result=(struct Library *)FindName(&SysBase->LibList,name))
            RemLibrary(result);
        Permit();
     }

INPUTS
    library - pointer to a library node structure