From 645943c03a60a61fc2494480cde1f051f8a14111 Mon Sep 17 00:00:00 2001 From: Josef Bacik Date: Wed, 11 Oct 2017 16:15:19 -0400 Subject: [PATCH 1/1] add documentation about filename_format directory behavior We've changed the behavior of filename_format, document that fact. Signed-off-by: Josef Bacik Signed-off-by: Jens Axboe --- HOWTO | 7 +++++++ fio.1 | 6 ++++++ 2 files changed, 13 insertions(+) diff --git a/HOWTO b/HOWTO index d3f957bf..a1513e12 100644 --- a/HOWTO +++ b/HOWTO @@ -795,6 +795,13 @@ Target file/device named :file:`testfiles.4`. The default of :file:`$jobname.$jobnum.$filenum` will be used if no other format specifier is given. + If you specify a path then the directories will be created up to the + main directory for the file. So for example if you specify + ``filename_format=a/b/c/$jobnum`` then the directories a/b/c will be + created before the file setup part of the job. If you specify + :option:`directory` then the path will be relative that directory, + otherwise it is treated as the absolute path. + .. option:: unique_filename=bool To avoid collisions between networked clients, fio defaults to prefixing any diff --git a/fio.1 b/fio.1 index 6e7d1f8b..7787ef29 100644 --- a/fio.1 +++ b/fio.1 @@ -578,6 +578,12 @@ fio generate filenames that are shared between the two. For instance, if `testfiles.$filenum' is specified, file number 4 for any job will be named `testfiles.4'. The default of `$jobname.$jobnum.$filenum' will be used if no other format specifier is given. +.P +If you specify a path then the directories will be created up to the main +directory for the file. So for example if you specify `a/b/c/$jobnum` then the +directories a/b/c will be created before the file setup part of the job. If you +specify \fBdirectory\fR then the path will be relative that directory, otherwise +it is treated as the absolute path. .RE .TP .BI unique_filename \fR=\fPbool -- 2.25.1