Recent changes (master)

Jens Axboe
2019-12-22T13:00:04Z

The following changes since commit 8d853d0bbf4487af9445f7253c1951970ce75200:

Merge branch 'mine/patch-2' of https://github.com/hannesweisbach/fio (2019-12-19 05:38:30 -0700)

are available in the Git repository at:

git://git.kernel.dk/fio.git master

for you to fetch changes up to ab1665679b00fd2b3f955596da837d9694732b24:

Merge branch 'doc_fixes' of https://github.com/sitsofe/fio (2019-12-21 07:04:58 -0700)

----------------------------------------------------------------
Jens Axboe (2):
Merge branch 'travis' of https://github.com/sitsofe/fio
Merge branch 'doc_fixes' of https://github.com/sitsofe/fio

Sitsofe Wheeler (5):
travis: remove duplicate xcode image and add comments
travis: switch to ubuntu 18.04 and install more libraries
doc: stop saying backslashes need escaping
HOWTO: fix up broken formatting in registerfiles section
doc: fix up sphinx warnings

.travis.yml | 9 ++++-----
HOWTO | 13 +++++++------
doc/conf.py | 2 +-
fio.1 | 8 ++++----
4 files changed, 16 insertions(+), 16 deletions(-)

---

Diff of recent changes:

diff --git a/.travis.yml b/.travis.yml
index eee31988..77c31b77 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,4 +1,5 @@
language: c
+dist: bionic
os:
- linux
compiler:
@@ -12,13 +13,11 @@ env:
- MAKEFLAGS="-j 2"
matrix:
include:
+ # Default xcode image
- os: osx
compiler: clang # Workaround travis setting CC=["clang", "gcc"]
env: BUILD_ARCH="x86_64"
- - os: osx
- compiler: clang
- osx_image: xcode9.4
- env: BUILD_ARCH="x86_64"
+ # Latest xcode image (needs periodic updating)
- os: osx
compiler: clang
osx_image: xcode11.2
@@ -33,7 +32,7 @@ matrix:
before_install:
- EXTRA_CFLAGS="-Werror"
- if [[ "$TRAVIS_OS_NAME" == "linux" ]]; then
- pkgs=(libaio-dev libnuma-dev libz-dev librbd-dev libibverbs-dev librdmacm-dev libcunit1 libcunit1-dev);
+ pkgs=(libaio-dev libcunit1 libcunit1-dev libgoogle-perftools4 libibverbs-dev libiscsi-dev libnuma-dev librbd-dev librdmacm-dev libz-dev);
if [[ "$BUILD_ARCH" == "x86" ]]; then
pkgs=("${pkgs[@]/%/:i386}");
pkgs+=(gcc-multilib python-scipy);
diff --git a/HOWTO b/HOWTO
index 41a667af..41d32c04 100644
--- a/HOWTO
+++ b/HOWTO
@@ -765,8 +765,8 @@ Target file/device
`filename` semantic (which generates a file for each clone if not
specified, but lets all clones use the same file if set).

- See the :option:`filename` option for information on how to escape "``:``" and
- "``\``" characters within the directory path itself.
+ See the :option:`filename` option for information on how to escape "``:``"
+ characters within the directory path itself.

Note: To control the directory fio will use for internal state files
use :option:`--aux-path`.
@@ -785,10 +785,10 @@ Target file/device
by this option will be :option:`size` divided by number of files unless an
explicit size is specified by :option:`filesize`.

- Each colon and backslash in the wanted path must be escaped with a ``\``
+ Each colon in the wanted path must be escaped with a ``\``
character. For instance, if the path is :file:`/dev/dsk/foo@3,0:c` then you
would use ``filename=/dev/dsk/foo@3,0\:c`` and if the path is
- :file:`F:\\filename` then you would use ``filename=F\:\\filename``.
+ :file:`F:\\filename` then you would use ``filename=F\:\filename``.

On Windows, disk devices are accessed as :file:`\\\\.\\PhysicalDrive0` for
the first device, :file:`\\\\.\\PhysicalDrive1` for the second etc.
@@ -2046,6 +2046,7 @@ with the caveat that when used on the command line, they must come after the
IO latency as well.

.. option:: registerfiles : [io_uring]
+
With this option, fio registers the set of files being used with the
kernel. This avoids the overhead of managing file counts in the kernel,
making the submission and completion part more lightweight. Required
@@ -2564,7 +2565,7 @@ I/O replay
(``blkparse <device> -o /dev/null -d file_for_fio.bin``).
You can specify a number of files by separating the names with a ':'
character. See the :option:`filename` option for information on how to
- escape ':' and '\' characters within the file names. These files will
+ escape ':' characters within the file names. These files will
be sequentially assigned to job clones created by :option:`numjobs`.

.. option:: read_iolog_chunked=bool
@@ -3990,7 +3991,7 @@ only file passed to :option:`read_iolog`. An example would look like::
$ fio --read_iolog="<file1>:<file2>" --merge_blktrace_file="<output_file>"

Creating only the merged file can be done by passing the command line argument
-:option:`merge-blktrace-only`.
+:option:`--merge-blktrace-only`.

Scaling traces can be done to see the relative impact of any particular trace
being slowed down or sped up. :option:`merge_blktrace_scalars` takes in a colon
diff --git a/doc/conf.py b/doc/conf.py
index 087a9a11..10b72ecb 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -177,7 +177,7 @@ html_theme = 'alabaster'
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+# html_static_path = ['_static']

# Add any extra paths that contain custom files (such as robots.txt or
# .htaccess) here, relative to this directory. These files are copied
diff --git a/fio.1 b/fio.1
index a60863f6..cf5dd853 100644
--- a/fio.1
+++ b/fio.1
@@ -536,7 +536,7 @@ set fio will use the first listed directory, and thereby matching the
specified, but lets all clones use the same file if set).
.RS
.P
-See the \fBfilename\fR option for information on how to escape ':' and '\\'
+See the \fBfilename\fR option for information on how to escape ':'
characters within the directory path itself.
.P
Note: To control the directory fio will use for internal state files
@@ -557,10 +557,10 @@ by this option will be \fBsize\fR divided by number of files unless an
explicit size is specified by \fBfilesize\fR.
.RS
.P
-Each colon and backslash in the wanted path must be escaped with a '\\'
+Each colon in the wanted path must be escaped with a '\\'
character. For instance, if the path is `/dev/dsk/foo@3,0:c' then you
would use `filename=/dev/dsk/foo@3,0\\:c' and if the path is
-`F:\\filename' then you would use `filename=F\\:\\\\filename'.
+`F:\\filename' then you would use `filename=F\\:\\filename'.
.P
On Windows, disk devices are accessed as `\\\\.\\PhysicalDrive0' for
the first device, `\\\\.\\PhysicalDrive1' for the second etc.
@@ -2277,7 +2277,7 @@ to replay a workload captured by blktrace. See
replay, the file needs to be turned into a blkparse binary data file first
(`blkparse <device> \-o /dev/null \-d file_for_fio.bin').
You can specify a number of files by separating the names with a ':' character.
-See the \fBfilename\fR option for information on how to escape ':' and '\'
+See the \fBfilename\fR option for information on how to escape ':'
characters within the file names. These files will be sequentially assigned to
job clones created by \fBnumjobs\fR.
.TP