From: Stephen Bates Date: Thu, 8 Jun 2017 18:10:10 +0000 (-0600) Subject: man: Update buffer_pattern entry in man pages X-Git-Tag: fio-2.21~8 X-Git-Url: https://git.kernel.dk/?p=fio.git;a=commitdiff_plain;h=85c705e55c2bbeb3c74d96ef4ec1ae90203c4083 man: Update buffer_pattern entry in man pages Update the fio man page to reflect the new usage of buffer_pattern. Signed-off-by: Stephen Bates Signed-off-by: Jens Axboe --- diff --git a/fio.1 b/fio.1 index e153d462..96eceafb 100644 --- a/fio.1 +++ b/fio.1 @@ -611,13 +611,20 @@ the remaining zeroed. With this set to some chunk size smaller than the block size, fio can alternate random and zeroed data throughout the IO buffer. .TP .BI buffer_pattern \fR=\fPstr -If set, fio will fill the IO buffers with this pattern. If not set, the contents -of IO buffers is defined by the other options related to buffer contents. The -setting can be any pattern of bytes, and can be prefixed with 0x for hex -values. It may also be a string, where the string must then be wrapped with -"", e.g.: +If set, fio will fill the I/O buffers with this pattern or with the contents +of a file. If not set, the contents of I/O buffers are defined by the other +options related to buffer contents. The setting can be any pattern of bytes, +and can be prefixed with 0x for hex values. It may also be a string, where +the string must then be wrapped with ``""``. Or it may also be a filename, +where the filename must be wrapped with ``''`` in which case the file is +opened and read. Note that not all the file contents will be read if that +would cause the buffers to overflow. So, for example: .RS .RS +\fBbuffer_pattern\fR='filename' +.RS +or +.RE \fBbuffer_pattern\fR="abcd" .RS or @@ -632,7 +639,7 @@ or Also you can combine everything together in any order: .LP .RS -\fBbuffer_pattern\fR=0xdeadface"abcd"-12 +\fBbuffer_pattern\fR=0xdeadface"abcd"-12'filename' .RE .RE .TP