mirror of
https://github.com/ceph/ceph
synced 2024-12-13 23:17:07 +00:00
60aea05423
Includes various content cleanups: layout of synopsis, layout of comments in examples, typos. Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
98 lines
2.4 KiB
ReStructuredText
98 lines
2.4 KiB
ReStructuredText
===========================================
|
|
csyn -- ceph synthetic workload generator
|
|
===========================================
|
|
|
|
.. program:: csyn
|
|
|
|
Synopsis
|
|
========
|
|
|
|
| **csyn** [ -m *monaddr*:*port* ] --syn *command* *...*
|
|
|
|
|
|
Description
|
|
===========
|
|
|
|
**csyn** is a simple synthetic workload generator for the Ceph
|
|
distributed file system. It uses the userspace client library to
|
|
generate simple workloads against a currently running file system. The
|
|
file system need not be mounted via cfuse(8) or the kernel client.
|
|
|
|
One or more ``--syn`` command arguments specify the particular
|
|
workload, as documented below.
|
|
|
|
|
|
Options
|
|
=======
|
|
|
|
.. option:: -d
|
|
|
|
Detach from console and daemonize after startup.
|
|
|
|
.. option:: -c ceph.conf, --conf=ceph.conf
|
|
|
|
Use *ceph.conf* configuration file instead of the default
|
|
``/etc/ceph/ceph.conf`` to determine monitor addresses during
|
|
startup.
|
|
|
|
.. option:: -m monaddress[:port]
|
|
|
|
Connect to specified monitor (instead of looking through
|
|
``ceph.conf``).
|
|
|
|
.. option:: --num_client num
|
|
|
|
Run num different clients, each in a separate thread.
|
|
|
|
.. option:: --syn workloadspec
|
|
|
|
Run the given workload. May be specified as many times as
|
|
needed. Workloads will normally run sequentially.
|
|
|
|
|
|
Workloads
|
|
=========
|
|
|
|
Each workload should be preceded by ``--syn`` on the command
|
|
line. This is not a complete list.
|
|
|
|
:command:`mknap` *path* *snapname*
|
|
Create a snapshot called *snapname* on *path*.
|
|
|
|
:command:`rmsnap` *path* *snapname*
|
|
Delete snapshot called *snapname* on *path*.
|
|
|
|
:command:`rmfile` *path*
|
|
Delete/unlink *path*.
|
|
|
|
:command:`writefile` *sizeinmb* *blocksize*
|
|
Create a file, named after our client id, that is *sizeinmb* MB by
|
|
writing *blocksize* chunks.
|
|
|
|
:command:`readfile` *sizeinmb* *blocksize*
|
|
Read file, named after our client id, that is *sizeinmb* MB by
|
|
writing *blocksize* chunks.
|
|
|
|
:command:`rw` *sizeinmb* *blocksize*
|
|
Write file, then read it back, as above.
|
|
|
|
:command:`makedirs` *numsubdirs* *numfiles* *depth*
|
|
Create a hierarchy of directories that is *depth* levels deep. Give
|
|
each directory *numsubdirs* subdirectories and *numfiles* files.
|
|
|
|
:command:`walk`
|
|
Recursively walk the file system (like find).
|
|
|
|
|
|
Availability
|
|
============
|
|
|
|
**csyn** is part of the Ceph distributed file system. Please refer to
|
|
the Ceph wiki at http://ceph.newdream.net/wiki for more information.
|
|
|
|
See also
|
|
========
|
|
|
|
:doc:`ceph <ceph>`\(8),
|
|
:doc:`cfuse <cfuse>`\(8)
|