RemLibrary

NAME

RemLibrary - remove a library from the system

SYNOPSIS

RemLibrary(library);
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.

INPUTS

library - pointer to a library node structure

EXAMPLE

 /* Attempts to flush the named library out of memory. */
 void FlushLibrary(STRPTR name)
 {
 struct Library *result;

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