'\" t .\" Title: kmsg_dump_get_buffer .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: January 2017 .\" Manual: Driver Basics .\" Source: Kernel Hackers Manual 4.8.15 .\" Language: English .\" .TH "KMSG_DUMP_GET_BUFFER" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "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_buffer \- copy kmsg log lines .SH "SYNOPSIS" .HP \w'bool\ kmsg_dump_get_buffer('u .BI "bool kmsg_dump_get_buffer(struct\ kmsg_dumper\ *\ " "dumper" ", bool\ " "syslog" ", char\ *\ " "buf" ", 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 \fIbuf\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 end of the kmsg buffer and fill the provided buffer with as many of the the *youngest* kmsg records that fit into it\&. If the buffer is large enough, all available kmsg records will be copied with a single call\&. .PP Consecutive calls will fill the buffer with the next block of available older records, not including the earlier retrieved ones\&. .PP A return value of FALSE indicates that there are no more records to read\&. .SH "COPYRIGHT" .br