FunctionPackage: exclToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
Unrevised from 8.0 to 8.1.
8.0 version

gc

Arguments: &optional mode (error t)

This function can be used to trigger a scavenge or global gc and to toggle some gsgc switches. The behavior depends on the mode argument. Possible values for mode and their effects are shown in the table below.

gc returns no values.

If mode is not one of the items in the table below, the system signals an error when error is true (the default) or prints a message that the mode is unknown but does not signal an error when error is nil. Thus:

(gc :foo t)
-> ERROR: Unknown option to gc: :foo 

(gc :foo nil)
-> Returns nothing, does nothing, prints: 
Unknown option to gc: :foo

See also gc.htm for general information on garbage collection in Allegro CL.

Value of mode Action
nil Perform a scavenge. This is the default.
t Perform a global garbage collection.
:mark-for-tenure Mark all surviving objects so that they are tenured as soon as convenient and perform a scavenge. Some or all of these objects may be tenured during the current scavenge and some (perhaps all) may be tenured during a later scavenge. (Objects with lispval-storage-type  :panified are never tenured and are thus unaffected.)
:tenure Perform a scavenge and tenure all surviving objects. All will be tenured when the call to gc completes (contrast with :mark-for-tenure, where some surviving objects may not be tenured after the call completes). Note that (gc :tenure) will likely take appreciably more time than (gc :mark-for-tenure). (Objects with lispval-storage-type  :panified are never tenured and are thus unaffected.)
:show Print the names and current values of gc switches and parameters. This argument does not trigger a scavenge or global gc.
:room Equivalent to (room t). This argument does not trigger a scavenge or global gc.
:print Toggles whether messages are printed when a gc occurs. This argument does not trigger a scavenge or global gc.
:help Prints the list of acceptable values for the type argument. This argument does not trigger a scavenge or global gc.

Copyright (c) 1998-2009, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 8.1. This page was not revised from the 8.0 page.
Created 2009.7.29.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
Unrevised from 8.0 to 8.1.
8.0 version