memlog-copy

Arguments: &key log stop start wait

Return a memory-log instance that contains a copy of the current memory log. Memory logging is suspended while the copy is made. This suspension is one possible cause for delays or skips in a memlog call. If a copy cannot be made, return nil.

If the log argument is specified, it must be a memory-log instance created in a previous call to memlog-copy. The current log is copied into the supplied object. If the current log is longer, the most recent entries are not copied.

If the stop argument is nil, the current log must be in the :stopped state. Otherwise, the current log is stopped before making the copy. The default is t.

The wait argument specifies how long to wait for the required state change. The default is nil, which means do not wait and return nil if a copy cannot be made. A non-negative integer means wait up to that number of seconds (no wait for 0). Any other non-nil value means wait as long as necessary.

The start argument specifes the state of memory logging after the copy is made. The allowed values are nil, :cond, or other non-nil. The default is :cond.

See Memlog: A Facility for Minimally Intrusive Monitoring of Complex Application Behavior in smp.htm for more information.

Copyright (c) 1998-2015, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 10.0. This page is new in the 10.0 release.
Created 2015.5.21.