[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