filebench(1)

📦 version 1.4.9.1+git.20200220, in fedora 43, fedora 44, opensuse-leap 16.0

💖 FILEBENCH 💖 (section 1, user commands, bestie)

okay so quick intro: this is the filebench manual page, and I'm about to make it make sense. filebench interprets WML script and generates appropriate filesystem workload. that's the whole vibe. 🦋

✨ NAME ✨

filebench — interprets WML script and generates appropriate filesystem workload

🌸 SYNOPSIS 🌸

filebench [-f <filename>] [-h]

💅 DESCRIPTION 💅

so. Filebench is a file system and storage benchmark that lets you generate a large variety of workloads. and unlike your typical benchmarks?? it is very flexible and lets you minutely specify (any) applications' behaviour using the extensive Workload Model Language (WML). like, any. that's the range. 💖

Filebench uses loadable workload personalities so you can easily emulate complex applications — think mail, web, file, and database servers. and it's quick to set up and easy to use compared to deploying real applications, which, no cap, is the whole point. it's also a handy tool for micro-benchmarking. ✨

Filebench includes many features to facilitate file system benchmarking, and honestly, the way it just does all this:

  • Multiple workload types support via loadable personalities 👑
  • Ships with more than 40 pre-defined personalities, including the one that describe mail, web, file, and database servers behaviour (yes, "describe", that's what it says, we don't gatekeep grammar here 💀)
  • Easy to add new personalities using reach Workload Model Language (WML) — again, that's the original wording, "reach", keeping it exactly as it is, fr fr 🫶
  • Multi-process and multi-thread workload support ⚡
  • Configurable directory hierarchies with depth, width, and file sizes set to given statistical distributions 📊
  • Support of asynchronous I/O and process synchronization primitives 🔄
  • Integrated statistics for throughput, latency, and CPU cycle counts per system call 📈

🎀 OPTIONS 🎀

  • -f <filename> — use specified file as an input instead of stdin. so instead of typing at it, you hand it a file. iconic.
  • -h — Display verbose help. it will yap. lovingly. 💬

🌈 EXAMPLES 🌈

Run filebench interactively: 🧚

$ filebench

Start filebench interactive shell, filebench prompt will appear after that.

filebench> load fileserver

Load fileserver personality using load command.

filebench> set $dir=/mnt

After personality is loaded, tunables of the workload personality can be set. Here we change the benchmark directory to /mnt where the file system we want to benchmark is presumably mounted.

filebench> run 60

Start workload for 60 seconds. After 60 seconds of the run the statistics is printed and Filebench exits.

Run filebench non-interactively: 🦋

filebench -f /usr/share/filebench/workloads/fileserver.f

Run filebench non-interactively, however, you need to add run <time> to the end of the workload personality file before calling filebench. like, it will NOT run itself, bestie, you gotta tell it. 😭

💜 EXIT STATUS 💜

  • 0 if OK, ✅
  • 1 if workload file is not found. 🙈

📣 REPORTING BUGS 📣

found a bug? go tell the people:

http://sourceforge.net/tracker/?group_id=133644&atid=727883

lowkey important: this page is revision 01, dated Sep 1, 2011, and it belongs to filebench(1). mwah. that's the whole page, you ate it, periodt. 💅✨🎀
📦 where this page comes from