Recent changes (master)
The following changes since commit dee9b29bef5bc344815d7a53dda6bb21426f2bfa:
Merge branch 'wip-rbd-engine-tweaks' of https://github.com/dillaman/fio (2020-12-15 09:18:28 -0700)
are available in the Git repository at:
git://git.kernel.dk/fio.git master
for you to fetch changes up to ced224611b039df68ceebde4733269f4f6606912:
Merge branch 'github_issue' of https://github.com/sitsofe/fio (2020-12-17 16:09:54 -0700)
----------------------------------------------------------------
Erwan Velu (4):
examples/fsx: Removing deprecated rwmixcycle options
examples: Clarify time_based usage
examples: Clarify thread usage
examples: Clarify group_reporting usage
Jens Axboe (2):
Merge branch 'evelu-examples' of https://github.com/ErwanAliasr1/fio
Merge branch 'github_issue' of https://github.com/sitsofe/fio
Sitsofe Wheeler (1):
docs: add new section to REPORTING-BUGS and github issue templates
.github/ISSUE_TEMPLATE.md | 5 +++++ .github/ISSUE_TEMPLATE/bug-report.md | 20 +++++++++++++++++++ .github/ISSUE_TEMPLATE/config.yml | 6 ++++++ .github/ISSUE_TEMPLATE/enhancement.md | 11 +++++++++++ .github/SUPPORT.md | 36 +++++++++++++++++++++++++++++++++++ REPORTING-BUGS | 31 +++++++++++++++++++++++++----- examples/cpp_null.fio | 2 +- examples/cross-stripe-verify.fio | 2 +- examples/dev-dax.fio | 4 ++-- examples/e4defrag.fio | 2 +- examples/e4defrag2.fio | 5 ++--- examples/exitwhat.fio | 2 +- examples/falloc.fio | 4 ++-- examples/fio-rand-RW.fio | 2 +- examples/fio-rand-read.fio | 2 +- examples/fio-rand-write.fio | 2 +- examples/fio-seq-RW.fio | 2 +- examples/fio-seq-read.fio | 2 +- examples/fio-seq-write.fio | 2 +- examples/fsx.fio | 1 - examples/jesd219.fio | 2 +- examples/libpmem.fio | 4 ++-- examples/libzbc-rand-write.fio | 2 +- examples/null.fio | 1 - examples/pmemblk.fio | 4 ++-- examples/steadystate.fio | 2 +- examples/surface-scan.fio | 2 +- examples/waitfor.fio | 2 +- examples/zbd-rand-write.fio | 2 +- 29 files changed, 130 insertions(+), 34 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE.md create mode 100644 .github/ISSUE_TEMPLATE/bug-report.md create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/enhancement.md create mode 100644 .github/SUPPORT.md
---
Diff of recent changes:
.github/ISSUE_TEMPLATE.md new file +5 -0
@@ -0,0 +1,5 @@ +**Please acknowledge you have done the following before creating a ticket** + +- [ ] I have read the GitHub issues section of [REPORTING-BUGS](../blob/master/REPORTING-BUGS). + +<!-- replace me with bug report / enhancement request -->
.github/ISSUE_TEMPLATE/bug-report.md new file +20 -0
@@ -0,0 +1,20 @@ +--- +name: Report a bug +about: For bugs that are reproducible with the latest fio releases + +--- + +**Please acknowledge the following before creating a ticket** + +- [ ] I have read the GitHub issues section of [REPORTING-BUGS](../blob/master/REPORTING-BUGS). + +**Description of the bug:** +<!--replaceme--> + +**Environment**: <!-- Name and version of operating system --> + +**fio version**: <!--replaceme--> + +**Reproduction steps** +<!-- Please minimise the job file/command line options down to only those +necessary to reproduce the issue (https://stackoverflow.com/help/mcve ) -->
.github/ISSUE_TEMPLATE/config.yml new file +6 -0
@@ -0,0 +1,6 @@ +blank_issues_enabled: true + +contact_links: +- name: General questions (e.g. "How do I...", "Why is...") that are related to fio + url: http://vger.kernel.org/vger-lists.html#fio + about: Please send questions to the fio mailing list (plain-text emails ONLY)
.github/ISSUE_TEMPLATE/enhancement.md new file +11 -0
@@ -0,0 +1,11 @@ +--- +name: Feature enhancement request +about: Suggest a new fio feature +labels: enhancement + +--- + +**Description of the new feature** +<!-- Please be aware regular fio developers are busy with non-fio work. Because +of this, most requests are only completed if someone from outside the project +contributes the code. -->
.github/SUPPORT.md new file +36 -0
@@ -0,0 +1,36 @@ +# Getting support for fio + +## General questions + +Please use the fio mailing list for asking general fio questions (e.g. "How do +I do X?", "Why does Y happen?"). See the Mailing list section of the +[README][readme] for details). + +## Reporting bugs + +As mentioned in [REPORTING-BUGS][reportingbugs], fio bugs and enhancements can +be reported to the fio mailing list or fio's GitHub issues tracker. + +When reporting bugs please include ALL of the following: +- Description of the issue +- fio version number tested. If your fio isn't among the recent releases (see + the [fio releases page][releases]) please build a new one from source (see + the Source and Building sections of the [README][readme] for how to do this) + and reproduce the issue with the fresh build before filing an issue. +- Reproduction steps and minimal job file/command line parameters. + +When requesting an enhancement only the description is needed. + +### GitHub issues specific information + +[Formatting terminal output with markdown][quotingcode] will help people who +are reading your report. However, if the output is large (e.g. over 15 lines +long) please consider including it as a text attachment. Avoid attaching +pictures of screenshots as these are not searchable/selectable. + +<!-- Definitions --> + +[readme]: ../README +[reportingbugs]: ../REPORTING-BUGS +[releases]: ../../../releases +[quotingcode]: https://docs.github.com/en/free-pro-team@latest/github/writing-on-github/basic-writing-and-formatting-syntax#quoting-code
REPORTING-BUGS +26 -5
@@ -1,16 +1,20 @@ Reporting a bug --------------- -If you notice anything that seems like a fio bug, please do send email -to the list ([email protected], see README) about it. If you are not -running the newest release of fio, upgrading first is recommended. +...via the mailing list +======================= + +If you notice anything that seems like a fio bug or want to ask fio related +questions, please send a plain-text only email to the list +([email protected], see README) about it. If you are not running the newest +release of fio please upgrade first. When reporting a bug, you'll need to include: 1) A description of what you think the bug is -2) Environment (Linux distro version, kernel version). This is mostly +2) Environment (e.g. Linux distro version, kernel version). This is mostly needed if it's a build bug. -3) The output from fio --version. +3) The output from fio --version . 4) How to reproduce. Please include a full list of the parameters passed to fio and the job file used (if any).
@@ -19,3 +23,20 @@ is left out and has to be asked for will add to the turn-around time of getting to the bottom of the issue, and an eventual fix. That's it! + +...via GitHub issues +==================== + +Please create an issue in the GitHub issue tracker +(https://github.com/axboe/fio/issues ) but observe the following: + +a) If you are asking a question on how to do something ("How do I/Why is?") + please send it to the mailing list and not GitHub issues. The fio project + uses GitHub issues for reproducible bugs/enhancement requests. +b) Please reproduce your bug using the latest fio listed on + https://github.com/axboe/fio/releases (see the Source and Building sections + of the README for how to build fio from source). +c) Include all of the information requested in the mailing list section above + (description, environment, version, reproduction steps and all job parameters). + +Thanks!
examples/cpp_null.fio +1 -1
@@ -7,4 +7,4 @@ ioengine=cpp_null size=100g rw=randread norandommap -time_based=0 +time_based
examples/cross-stripe-verify.fio +1 -1
@@ -17,7 +17,7 @@ verify_backlog=1 offset_increment=124g io_size=120g offset=120k -group_reporting=1 +group_reporting verify_dump=1 loops=2
examples/dev-dax.fio +2 -2
@@ -2,7 +2,7 @@ bs=2m ioengine=dev-dax norandommap -time_based=1 +time_based runtime=30 group_reporting disable_lat=1
@@ -18,7 +18,7 @@ cpus_allowed_policy=split # iodepth=1 direct=0 -thread=1 +thread numjobs=16 # # The dev-dax engine does IO to DAX device that are special character
examples/e4defrag.fio +1 -1
@@ -18,7 +18,7 @@ rw=write # Run e4defrag and aio-dio workers in parallel [e4defrag] stonewall -time_based=30 +time_based runtime=30 ioengine=e4defrag buffered=0
examples/e4defrag2.fio +2 -3
@@ -55,7 +55,7 @@ inplace=1 bs=4k donorname=file3.def filename=file3 -time_based=30 +time_based rw=randwrite [buffered-aio-32k]
@@ -68,7 +68,7 @@ bs=32k filename=file3 rw=randrw runtime=30 -time_based=30 +time_based numjobs=4 [direct-aio-32k]
@@ -82,7 +82,6 @@ bs=32k filename=file3 rw=randrw runtime=30 -time_based=30 numjobs=4
examples/exitwhat.fio +1 -1
@@ -11,7 +11,7 @@ filename=/tmp/test filesize=1G blocksize=4096 -group_reporting=1 +group_reporting exitall=1 [slow1]
examples/falloc.fio +2 -2
@@ -15,7 +15,7 @@ group_reporting [falloc-fuzzer] stonewall runtime=10 -time_based=10 +time_based bssplit=4k/10:64k/50:32k/40 rw=randwrite numjobs=1
@@ -24,7 +24,7 @@ filename=fragmented_file [punch hole-fuzzer] bs=4k runtime=10 -time_based=10 +time_based rw=randtrim numjobs=2 filename=fragmented_file
examples/fio-rand-RW.fio +1 -1
@@ -9,7 +9,7 @@ rwmixwrite=40 bs=4K direct=0 numjobs=4 -time_based=1 +time_based runtime=900 [file1]
examples/fio-rand-read.fio +1 -1
@@ -7,7 +7,7 @@ rw=randread bs=4K direct=0 numjobs=1 -time_based=1 +time_based runtime=900 [file1]
examples/fio-rand-write.fio +1 -1
@@ -7,7 +7,7 @@ rw=randwrite bs=4K direct=0 numjobs=4 -time_based=1 +time_based runtime=900 [file1]
examples/fio-seq-RW.fio +1 -1
@@ -9,7 +9,7 @@ rwmixwrite=40 bs=256K direct=0 numjobs=4 -time_based=1 +time_based runtime=900 [file1]
examples/fio-seq-read.fio +1 -1
@@ -5,7 +5,7 @@ rw=read bs=256K direct=1 numjobs=1 -time_based=1 +time_based runtime=900 [file1]
examples/fio-seq-write.fio +1 -1
@@ -7,7 +7,7 @@ rw=write bs=256K direct=0 numjobs=1 -time_based=1 +time_based runtime=900 [file1]
examples/fsx.fio +0 -1
@@ -9,4 +9,3 @@ bs=4k norandommap direct=1 loops=500000 -rwmixcycle=40
examples/jesd219.fio +1 -1
@@ -17,4 +17,4 @@ bssplit=512/4:1024/1:1536/1:2048/1:2560/1:3072/1:3584/1:4k/67:8k/10:16k/7:32k/3: blockalign=4k random_distribution=zoned:50/5:30/15:20/80 filename=/dev/nvme0n1 -group_reporting=1 +group_reporting
examples/libpmem.fio +2 -2
@@ -3,7 +3,7 @@ bs=4k size=8g ioengine=libpmem norandommap -time_based=1 +time_based group_reporting invalidate=1 disable_lat=1
@@ -13,7 +13,7 @@ clat_percentiles=0 iodepth=1 iodepth_batch=1 -thread=1 +thread numjobs=1 runtime=300
examples/libzbc-rand-write.fio +1 -1
@@ -12,7 +12,7 @@ max_open_zones=32 bs=512K direct=1 numjobs=16 -time_based=1 +time_based runtime=300 [dev1]
examples/null.fio +0 -1
@@ -7,4 +7,3 @@ ioengine=null size=100g rw=randread norandommap -time_based=0
examples/pmemblk.fio +2 -2
@@ -2,7 +2,7 @@ bs=1m ioengine=pmemblk norandommap -time_based=1 +time_based runtime=30 group_reporting disable_lat=1
@@ -19,7 +19,7 @@ cpus_allowed_policy=split # iodepth=1 direct=1 -thread=1 +thread numjobs=16 # # Unlink can be used to remove the files when done, but if you are
examples/steadystate.fio +1 -1
@@ -7,7 +7,7 @@ [global] threads=1 -group_reporting=1 +group_reporting time_based size=128m
examples/surface-scan.fio +1 -1
@@ -1,7 +1,7 @@ ; writes 512 byte verification blocks until the disk is full, ; then verifies written data [global] -thread=1 +thread bs=64k direct=1 ioengine=sync
examples/waitfor.fio +1 -1
@@ -1,6 +1,6 @@ [global] threads=1 -group_reporting=1 +group_reporting filename=/tmp/data filesize=128m
examples/zbd-rand-write.fio +1 -1
@@ -12,7 +12,7 @@ max_open_zones=32 bs=512K direct=1 numjobs=16 -time_based=1 +time_based runtime=180 [dev1]