<< Previous | Next >>

log_seek

int log_seek( LogDest ldst, int );

Description

Position log for readback. The next call to log_next() will return the first entry in the log (if whence=0), or log_prev() will return the last entry (if whence=1).

NOTE	Please see the comments at the top of log.lib for a description of the message logging subsystem.

Parameters

ldst

Destination class and stream. Use one of the constants LOG_DEST_FS2 or LOG_DEST_XMEM, then OR in the stream number (0-63).

whence

0: first entry.
1: last entry.
other values reserved.

Return Value

 0 = success.
-1 = Log empty.
-2 = Unrecoverable error or not open.
-3 = Not a seekable or configured log destination class.
-4 = invalid whence parameter.

Library

log.lib

See Also

log_next, log_prev