hackbench(8)                                                      hackbench(8)

# SPDX-License-Identifier: GPL-2.0-or-later

<?><?><?> (NAME)
       hackbench - <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       hackbench [-f|--fds NUM]  [-F|--fifo]  [-g|--groups NUM]  [-h|--help]
       [-l|--loops LOOPS]  [-p|--pipe]  [-s|--datasize SIZE]  [-T|--threads]
       [-P|--process]


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> Hackbench <?><?> <?><?> <?><?><?> (benchmark) <?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> (stress test)
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?>. <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> (<?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?>) <?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.


<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?> ("--") <?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?>:

       -f, --fds=NUM
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?>.

       -F,--fifo
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?> SCHED_FIFO <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> (workers).  <?><?><?> <?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>.

       -g, --groups=NUM
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>.

       -h, --help
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

       -l, --loops=LOOPS
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?><?>/<?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?>.

       -p, --pipe
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?> (pipe) <?><?> <?><?><?> <?><?><?><?>
              (<?><?><?><?><?><?><?>).

       -s, --datasize=SIZE
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>.

       -T, --threads
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>/<?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?> <?><?><?><?> POSIX <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       -P, --process
              <?><?><?><?><?> Hackbench <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> fork() <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> (<?><?><?><?><?>
              <?><?><?><?><?><?><?>).

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?> hackbench <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> fork() <?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?>:

       user@host: ~ $ hackbench
       Running in process mode with 10 groups using 40 file descriptors each (== 400 tasks)
       Each sender will pass 100 messages of 100 bytes
       Time: 0.890

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> fork():

       user@host: ~ $ hackbench --pipe --threads   (or hackbench -p -T)
       Running in threaded mode with 10 groups using 40 file descriptors each (== 400 tasks)
       Each sender will pass 100 messages of 100 bytes
       Time: 0.497

       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>/<?><?><?><?><?><?>
       <?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>:

       user@host: ~ $ hackbench -s 512 -l 200 -g 15 -f 25 -P
       Running in process mode with 15 groups using 50 file descriptors each (== 750 tasks)
       Each sender will pass 200 messages of 512 bytes
       Time: 4.497

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?><?><?> hackbench <?><?><?><?> Rusty Russell
       <rusty@rustcorp.com.au> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> Yanmin Zhang
       <yanmin_zhang@linux.intel.com><?> Ingo Molnar <mingo@elte.hu> <?> David
       Sommerseth <davids@redhat.com>.

       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> Clark Williams
       <williams@redhat.com> <?> David Sommerseth <davids@redhat.com>
       <?><?><?><?><?><?> <?><?><?> <?><?><?>.

<?><?><?><?><?><?><?> (HISTORY)
       <?><?><?> <?><?><?><?> <?><?> hackbench <?><?> <?><?><?><?> <?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <http://people.redhat.com/mingo/cfs-scheduler/tools/hackbench.c>
       <?><?><?><?><?><?> <?><?><?> <?><?><?>.  Yanmin Zhang <?><?>
       <?><?><?><?> hackbench <?><?><?><?><?><?><?> <?><?>
       <http://devresources.linuxfoundation.org/craiger/hackbench/src/hackbench.c>
       <?><?> <?><?> <?><?> fork() <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <http://www.bullopensource.org/posix/pi-futex/hackbench_pth.c> <?><?>
       <?><?><?><?> <?><?> pthread <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>. <?><?> <?><?> <?><?><?><?><?> Hackbench
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> fork() <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

                              September 19, 2020                  hackbench(8)