Charles.Forsyth20060303-partialeea662d19 years agoHistory
45 lines · 1.1 KB · Text
RawDownload
.TH LOGFILE 4.SH NAMElogfile \- memory-based append-only circular storage buffer.SH SYNOPSIS.B logfile.RB [ \-\fIsize\fP ].I \fIfile\fP.SH DESCRIPTION.I Logfilecreates a name at.I file(the containing directory must already exist).Each write to.I fileappends the written data up to a maximum of.I sizebytes; subsequent writes erase the existingdata in a circular fashion. A read from.I filewill return any currently stored data, if any;if there is none, then it will block until moredata becomes available.Multiple readers will receive the data independentlyof one another. If a writing process is consistentlyproducing data faster than a reading process, thenthe data read will have some bytes elided; a writeis never blocked..SH SOURCE.B /appl/cmd/logfile.b.SH SEE ALSO.IR wm-logwindow (1),.IR sys-file2chan (2).SH BUGSRestrictions on.IR sys-file2chan (2)mean that the.I logfileprocess will not terminate automaticallywhen its file is removed or unmounted..PPThere is no indication to a reader of anymissing data..PPIt is not possible to do a non-blockingread of the log file.