NFSTEST_IO(1)

📦 version 3.2, in debian trixie, fedora 43, fedora 44, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 nfstest_io — bestie's guide to the I/O tool

okay so this is the manual page for nfstest_io, which ships as part of the nfstest_io 1.2 thing and lives in section 1 of the manual (you know, the "run this in your shell" section). it's an I/O tool. it makes files and then messes with them. iconic behaviour honestly. 🦋

✨ NAME ✨

nfstest_io — I/O tool 🎀

🌸 SYNOPSIS 🌸

nfstest_io -d <datadir> [options]

💖 DESCRIPTION 💖

so basically this I/O tool is here to create and manipulate files of different types. the arguments let you run it for a specified period of time, and they also let you run multiple processes at once. lowkey flexible.

here's the cute part: each process modifies a single file at a time, and the file name space is different for each process. which means there are no collisions between two different processes modifying the same file. it's giving organized. it's giving considerate. no cap. ✨

👑 OPTIONS 👑

  • --version — show the program's version number and dip out 🫶
  • -h, --help — show this help message and then exit, slay
  • -d DATADIR, --datadir=DATADIR — the top level directory where files will be created. if it doesn't exist yet, don't even worry, it'll get created for you 💖
  • -s SEED, --seed=SEED — the seed used to initialize the random number generator [default: automatically generated] 🎲
  • -n NPROCS, --nprocs=NPROCS — how many processes to use [default: 1]
  • -r RUNTIME, --runtime=RUNTIME — run time [default: '0']
  • -v VERBOSE, --verbose=VERBOSE — verbose level, pick your vibe: none|info|debug|dbg1-7|all [default: 'none']
  • -e, --exiterr — exit on the first error, no second chances bestie

📖 Read and write:

  • --read=READ — read file percentage [default: 40.0]
  • --write=WRITE — write file percentage [default: 40.0]
  • --rdwr=RDWR — read/write file percentage [default: 20.0]
  • --randio=RANDIO — random file access percentage [default: 50.0]
  • --iodelay=IODELAY — seconds to delay I/O operations [default: 0.0] (yes queen, take your time)
  • --direct — use direct I/O ⚡
  • --rdwronly — use read and write only. no rename, no remove, none of that drama, just read and write. periodt.

🗂️ File operations:

  • --create=CREATE — create file percentage [default: 5.0]
  • --odgrade=ODGRADE — open downgrade percentage [default: 5.0]
  • --osync=OSYNC — open file with O_SYNC [default: 10.0]
  • --fsync=FSYNC — percentage of fsync after write [default: 2.0]
  • --rename=RENAME — rename file percentage [default: 5.0]
  • --remove=REMOVE — remove file percentage [default: 5.0]
  • --trunc=TRUNC — truncate file percentage [default: 2.0]
  • --ftrunc=FTRUNC — truncate opened file percentage [default: 2.0]
  • --link=LINK — create hard link percentage [default: 1.0]
  • --slink=SLINK — create symbolic link percentage [default: 0.2]
  • --readdir=READDIR — list contents of directory percentage [default: 0.5]
  • --lock=LOCK — lock file percentage [default: 20.0]
  • --unlock=UNLOCK — unlock file percentage [default: 80.0]
  • --tlock=TLOCK — lock test percentage [default: 20.0]
  • --lockfull=LOCKFULL — lock full file percentage [default: 50.0]
  • --minfiles=MINFILES — minimum number of files to create before any file operation is executed [default: 10]

📏 File size options:

  • --fsizeavg=FSIZEAVG — file size average [default: 1m]
  • --fsizedev=FSIZEDEV — file size standard deviation [default: 256k]
  • --rsize=RSIZE — read block size [default: 64k]
  • --rsizedev=RSIZEDEV — read block size standard deviation [default: 8k]
  • --wsize=WSIZE — write block size [default: 64k]
  • --wsizedev=WSIZEDEV — write block size standard deviation [default: 8k]
  • --sizemult=SIZEMULT — size multiplier [default: 1.0]

📝 Logging options:

  • --createlog — create log file 📄
  • --createlogs — create a log file for each process 📚
  • --logdir=LOGDIR — log directory [default: '/tmp']

🫶 SEE ALSO 🫶

nfstest.file_io(3), nfstest_alloc(1), nfstest_cache(1), nfstest_delegation(1), nfstest_dio(1), nfstest_fcmp(1), nfstest_file(1), nfstest_interop(1), nfstest_lock(1), nfstest_pkt(1), nfstest_pnfs(1), nfstest_posix(1), nfstest_rdma(1), nfstest_sparse(1), nfstest_ssc(1), nfstest_xattr(1), nfstest_xid(1)

the whole friend group honestly, go say hi 💜

💀 BUGS 💀

No known bugs. (not a single one. the way that she's flawless? 😭 we love to see it. not me being suspicious though 🙈)

✍️ AUTHOR ✍️

Jorge Mora (mora@netapp.com) — thank you for your service, king 👑

and that's a wrap bestie!! this page is from NFStest 3.2, dated 21 March 2023, and if you ever forget any of it just run man nfstest_io and come right back. mwah 💅✨🌸

📦 where this page comes from