RTEMS Logo

RTEMS 4.6.4 On-Line Library


Event Logging Manager log_seek - Reposition log file offset

PREV UP NEXT Bookshelf New Chapters

1.4.8: log_seek - Reposition log file offset

CALLING SEQUENCE:

#include <evlog.h>

int log_seek(
  const logd_t    logdes,
  log_recid_t     log_recid
);

STATUS CODES:

A successful call to log_seek() returns a value of zero and an unsuccessful call returns the errno.

EBADF
The logdes argument is not a valid log file descriptor.
EINVAL
The log_recid argument is not a valid record id.

DESCRIPTION:

The log_seek() function sets the log file offset of the open log description associated with the logdes log file descriptor to the event record in the log file identified by log_recid. The log_recid argument is either the record id of a valid event record or one of the following values, as defined in the header file <evlog.h>:

LOG_SEEK_START
Set log file position to point at the first event record in the log file.
LOG_SEEK_END
Set log file position to point after the last event record in the log file.

NOTES:

The _POSIX_LOGGING feature flag is defined to indicate this service is available.

This implementation can not return EINTR.

This implementation can not return EINVAL to indicate that the log_recid argument is not a valid record id.


PREV UP NEXT Bookshelf New Chapters

Copyright © 1988-2004 OAR Corporation