PreviousNext

dce_svc_log_get(3dce)

Reads the next record from a binary log file

Synopsis

#include <dce/dce.h>
#include <pthread.h>
#include <dce/svclog.h>

void dce_svc_log_get(

dce_svc_log_handle_t handle,
dce_svc_log_prolog_t *prolog,
error_status_t *status);

Parameters

Input

handle
The handle (returned by dce_svc_log_open( )) of the log file to be read.

Output

prolog
A pointer to a structure containing information read from the log file record.

status
Returns the status code from this operation. The status code is a value that indicates whether the routine completed successfully and if not, why not.

Description
The dce_svc_log_get( ) routine reads the next entry from a binary format serviceability log, and fills in prolog with a pointer to a private data area containing the data read. The contents of the prolog structure are defined in dce/svclog.h.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

See dce_svc_register(3dce).

Related Information
Functions: dce_svc_log_close(3dce)

dce_svc_log_open(3dce)

dce_svc_log_rewind(3dce)