CEPH-SYN(8)

📦
version 20.2.4 · 20 versions
, in ubuntu stonking

💖 NAME 💖

ceph-syn — the ceph synthetic workload generator, aka ur new fave chaos gremlin that makes fake work for ur filesystem to do 🦋

✨ SYNOPSIS ✨

ceph-syn [ -m monaddr:port ] --syn command ...

🌸 DESCRIPTION 🌸

okay so bestie, ceph-syn is a simple synthetic workload generator for the Ceph distributed file system. no cap. it uses the userspace client library to generate simple workloads against a file system that's currently running — and here's the slay part: the file system does NOT need to be mounted via ceph-fuse(8) or the kernel client. it just goes straight in. iconic behavior honestly 💅

one or more --syn command arguments specify the particular workload u want, and they're all documented right down below. periodt.

🎀 OPTIONS 🎀

  • -d — detach from the console and daemonize after startup. bye girl, ur on ur own now 👋
  • -c ceph.conf, --conf=ceph.conf — use ceph.conf configuration file instead of the default /etc/ceph/ceph.conf to figure out monitor addresses during startup. custom config? we love that for u 💖
  • -m monaddress[:port] — connect to the specified monitor instead of going looking through ceph.conf. direct line, no middleman ✨
  • --num_client num — run num different clients, each one in a separate thread. multitasking queen energy 👑
  • --syn workloadspec — run the given workload. u can specify this as many times as u need, fr fr. workloads will normally run sequentially.

🦋 WORKLOADS 🦋

each workload should be preceded by --syn on the command line. also, heads up: this is not a complete list, so don't come for me 😭

  • mknap path snapname — create a snapshot called snapname on path. lil snapshot baby, so cute 🎀
  • rmsnap path snapname — delete the snapshot called snapname on path. not me ending it 💀
  • rmfile path — delete/unlink path. gone. reduced to atoms ✨
  • writefile sizeinmb blocksize — create a file, named after our client id, that is sizeinmb MB, by writing blocksize chunks. build her up 🧚
  • readfile sizeinmb blocksize — read the file, named after our client id, that is sizeinmb MB, by writing blocksize chunks.
  • rw sizeinmb blocksize — write the file, then read it back, as above. it's giving writer-to-reader pipeline 🌈
  • makedirs numsubdirs numfiles depth — create a hierarchy of directories that is depth levels deep. give each directory numsubdirs subdirectories and numfiles files. nested like a russian doll, obsessed 🪆
  • walk — recursively walk the file system, basically like find. main character taking a stroll 🌸

💜 AVAILABILITY 💜

ceph-syn is part of Ceph — a massively scalable, open-source, distributed storage system. if u want more info, pls refer to the Ceph documentation at <https://docs.ceph.com>. go read it, it's good for u 🫶

⭐ SEE ALSO ⭐

ceph(8), ceph-fuse(8)

2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)

okay that's the whole thing, ily, go generate some workloads 💖✨ this fab lil page is dev, dated Oct 06, 2026, and it lives in the CEPH-SYN(8) chapter of the manual. mwah, bye bestie 🎀🦋💅

📦 where this page comes from