gem-graph-client/doc/rtfm/man3/journal.c.3

214 lines
4.2 KiB
Groff
Raw Normal View History

.TH "src/journal.c" 3 "Version 0.1.0" "Gem-graph" \" -*- nroff -*-
.ad l
.nh
.SH NAME
src/journal.c \- journal / log
.SH SYNOPSIS
.br
.PP
\fC#include <stdio\&.h>\fP
.br
\fC#include <stdlib\&.h>\fP
.br
\fC#include <time\&.h>\fP
.br
\fC#include <string\&.h>\fP
.br
\fC#include <sys/time\&.h>\fP
.br
\fC#include '\&.\&./include/fsm\&.h'\fP
.br
.SS "Functions"
.in +1c
.ti -1c
.RI "void \fBfsm_journal_init\fP (\fBfsm_struct_journal\fP *jj)"
.br
2024-10-20 01:05:12 +02:00
.RI "init the journal "
.ti -1c
.RI "void \fBfsm_journal_clear\fP (\fBfsm_struct_journal\fP *jj, const char *file_source, const char *function_source, const char *string_value)"
.br
2024-10-20 01:05:12 +02:00
.RI "usefulness ? (systematic ^c) "
.ti -1c
.RI "void \fBfsm_journal_push_front\fP (\fBfsm_struct_journal\fP *jj, const char *file_source, const char *function_source, const char *string_value)"
.br
2024-10-20 01:05:12 +02:00
.RI "add an event "
.ti -1c
.RI "long \fBfsm_journal_pop_back\fP (\fBfsm_struct_journal\fP *jj, const char *file_source, const char *function_source, const char *string_value)"
.br
2024-10-20 01:05:12 +02:00
.RI "remove an event "
.ti -1c
.RI "int \fBfsm_journal_length\fP (\fBfsm_struct_journal\fP jj)"
.br
2024-10-20 01:05:12 +02:00
.RI "get journal_length "
.ti -1c
.RI "void \fBfsm_journal_seek\fP (\fBfsm_struct_journal\fP jj, long usec, const char *file_source, const char *function_source, const char *string_value)"
.br
2024-10-20 01:05:12 +02:00
.RI "seek for an event "
.ti -1c
.RI "void \fBfsm_journal_publish\fP (\fBfsm_struct_journal\fP jj)"
.br
2024-10-20 01:05:12 +02:00
.RI "publish all the logs today just print in the console TODO > in a file "
.in -1c
.SH "Detailed Description"
.PP
journal / log
2024-10-20 01:05:12 +02:00
This file is part of Gem-graph\&. The journal stores chronologically the events during a session run (rules exec, mainly)
.PP
What types of events should be reported ? (fsm, widgets, \&.\&.\&. ) For what purpose ? What information must be collected and transmitted ? How to name and classify this information ? How to present it ?
.PP
date key (rank) source file source function +/- value
.PP
(notes) time_t current_time = time(NULL); < Check if the time retrieval was successful if (current_time == ((time_t)-1)) printf('Error getting current time\&.\\n'); Convert to local time format and print printf(' Current timestamp: %ld %s\\n', current_time, message); printf(' Current time: %s', ctime(&current_time));
.SH "Function Documentation"
.PP
.SS "void fsm_journal_clear (\fBfsm_struct_journal\fP * jj, const char * file_source, const char * function_source, const char * string_value)"
.PP
2024-10-20 01:05:12 +02:00
usefulness ? (systematic ^c)
.PP
2024-10-20 01:05:12 +02:00
\fBSince\fP
.RS 4
2024-10-20 01:05:12 +02:00
2024-09
.RE
.PP
\fBParameters\fP
.RS 4
2024-10-20 01:05:12 +02:00
\fI*jj\fP
.br
\fI*file_source\fP
.br
\fI*function_source\fP
.br
2024-10-20 01:05:12 +02:00
\fI*string_value\fP
.RE
.PP
2024-10-20 01:05:12 +02:00
.SS "void fsm_journal_init (\fBfsm_struct_journal\fP * jj)"
.PP
2024-10-20 01:05:12 +02:00
init the journal
.PP
2024-10-20 01:05:12 +02:00
\fBSince\fP
.RS 4
2024-10-20 01:05:12 +02:00
2024-09
.RE
.PP
\fBParameters\fP
.RS 4
2024-10-20 01:05:12 +02:00
\fI*jj\fP
.RE
.PP
2024-10-20 01:05:12 +02:00
.SS "int fsm_journal_length (\fBfsm_struct_journal\fP jj)"
.PP
2024-10-20 01:05:12 +02:00
get journal_length
.PP
2024-10-20 01:05:12 +02:00
\fBSince\fP
.RS 4
2024-10-20 01:05:12 +02:00
2024-09
.RE
.PP
2024-10-20 01:05:12 +02:00
\fBParameters\fP
.RS 4
2024-10-20 01:05:12 +02:00
\fI*jj\fP
.RE
.PP
2024-10-20 01:05:12 +02:00
\fBReturns\fP
.RS 4
2024-10-20 01:05:12 +02:00
journal length
.RE
.PP
2024-10-20 01:05:12 +02:00
.SS "long fsm_journal_pop_back (\fBfsm_struct_journal\fP * jj, const char * file_source, const char * function_source, const char * string_value)"
.PP
2024-10-20 01:05:12 +02:00
remove an event
.PP
2024-10-20 01:05:12 +02:00
\fBSince\fP
.RS 4
2024-10-20 01:05:12 +02:00
2024-09
.RE
.PP
\fBParameters\fP
.RS 4
2024-10-20 01:05:12 +02:00
\fI*jj\fP
.br
\fI*file_source\fP
.br
\fI*function_source\fP
.br
\fI*string_value\fP
.RE
.PP
2024-10-20 01:05:12 +02:00
.SS "void fsm_journal_publish (\fBfsm_struct_journal\fP jj)"
.PP
2024-10-20 01:05:12 +02:00
publish all the logs today just print in the console TODO > in a file
.PP
2024-10-20 01:05:12 +02:00
\fBSince\fP
.RS 4
2024-10-20 01:05:12 +02:00
2024-09
.RE
.PP
\fBParameters\fP
.RS 4
2024-10-20 01:05:12 +02:00
\fI*jj\fP
.RE
.PP
2024-10-20 01:05:12 +02:00
.SS "void fsm_journal_push_front (\fBfsm_struct_journal\fP * jj, const char * file_source, const char * function_source, const char * string_value)"
.PP
2024-10-20 01:05:12 +02:00
add an event
.PP
2024-10-20 01:05:12 +02:00
\fBSince\fP
.RS 4
2024-10-20 01:05:12 +02:00
2024-09
.RE
.PP
\fBParameters\fP
.RS 4
2024-10-20 01:05:12 +02:00
\fI*jj\fP
.br
\fI*file_source\fP
.br
\fI*function_source\fP
.br
\fI*string_value\fP
.RE
.PP
2024-10-20 01:05:12 +02:00
.SS "void fsm_journal_seek (\fBfsm_struct_journal\fP jj, long usec, const char * file_source, const char * function_source, const char * string_value)"
.PP
2024-10-20 01:05:12 +02:00
seek for an event
.PP
2024-10-20 01:05:12 +02:00
\fBSince\fP
.RS 4
2024-10-20 01:05:12 +02:00
2024-09
.RE
.PP
\fBParameters\fP
.RS 4
2024-10-20 01:05:12 +02:00
\fI*jj\fP
.br
\fIusec\fP
.br
\fI*file_source\fP
.br
\fI*function_source\fP
.br
\fI*string_value\fP
.RE
.PP
2024-10-20 01:05:12 +02:00
.SH "Author"
.PP
Generated automatically by Doxygen for Gem-graph from the source code\&.