NAME

RemLibrary: remove a library from the system

SYNOPSIS

RemLibrary(library)

void RemLibrary(struct Library *);

FUNCTION

This function calls the library's EXPUNGE function, 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 proto/exec.h
#include exec/execbase.h

void FlushLibrary(STRPTR name)
{

struct Library *result;

Forbid();

result = (struct Library *)FindName(&SysBase->LibList, name);
if (result != NULL)

RemLibrary(result);

Permit();

}

INPUTS

library: pointer to a library node structure