[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