'\" t .\" Title: kmsg_dump_get_line .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.78.1 .\" Date: May 2018 .\" Manual: Driver Basics .\" Source: Kernel Hackers Manual 3.16.56 .\" Language: English .\" .TH "KMSG_DUMP_GET_LINE" "9" "May 2018" "Kernel Hackers Manual 3\&.16\&" "Driver Basics" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" kmsg_dump_get_line \- retrieve one kmsg log line .SH "SYNOPSIS" .HP \w'bool\ kmsg_dump_get_line('u .BI "bool kmsg_dump_get_line(struct\ kmsg_dumper\ *\ " "dumper" ", bool\ " "syslog" ", char\ *\ " "line" ", size_t\ " "size" ", size_t\ *\ " "len" ");" .SH "ARGUMENTS" .PP \fIdumper\fR .RS 4 registered kmsg dumper .RE .PP \fIsyslog\fR .RS 4 include the \(lq<4>\(rq prefixes .RE .PP \fIline\fR .RS 4 buffer to copy the line to .RE .PP \fIsize\fR .RS 4 maximum size of the buffer .RE .PP \fIlen\fR .RS 4 length of line placed into buffer .RE .SH "DESCRIPTION" .PP Start at the beginning of the kmsg buffer, with the oldest kmsg record, and copy one record into the provided buffer\&. .PP Consecutive calls will return the next available record moving towards the end of the buffer with the youngest messages\&. .PP A return value of FALSE indicates that there are no more records to read\&. .SH "COPYRIGHT" .br