From: Josef Bacik <jbacik@xxxxxx> We've changed the behavior of filename_format, document that fact. Signed-off-by: Josef Bacik <jbacik@xxxxxx> --- HOWTO | 7 +++++++ fio.1 | 6 ++++++ 2 files changed, 13 insertions(+) diff --git a/HOWTO b/HOWTO index d3f957bf4db7..a1513e1259f7 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 6e7d1f8b1e46..7787ef29c2b3 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.7.4 -- To unsubscribe from this list: send the line "unsubscribe fio" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
