Skip to content

Latest commit

 

History

History
45 lines (31 loc) · 972 Bytes

RemLibrary.md

File metadata and controls

45 lines (31 loc) · 972 Bytes
Raw

NAME

RemLibrary -- remove a library from the system

SYNOPSIS

    RemLibrary(library)
               A1

    void RemLibrary(struct Library *);

Links: 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