components/sysbench/files/sysbench.1

   1 '\" t
   2 .\"
   3 .\" CDDL HEADER START
   4 .\"
   5 .\" The contents of this file are subject to the terms of the
   6 .\" Common Development and Distribution License (the "License").
   7 .\" You may not use this file except in compliance with the License.
   8 .\"
   9 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  10 .\" or http://www.opensolaris.org/os/licensing.
  11 .\" See the License for the specific language governing permissions
  12 .\" and limitations under the License.
  13 .\"
  14 .\" When distributing Covered Code, include this CDDL HEADER in each
  15 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  16 .\" If applicable, add the following below this CDDL HEADER, with the
  17 .\" fields enclosed by brackets "[]" replaced with your own identifying
  18 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  19 .\"
  20 .\" CDDL HEADER END
  21 .\"
  22 .\" ident       "@(#)sysbench.1.sunman  1.2     10/03/16 SMI"
  23 .\" "Copyright 2010 Sun Microsystems, Inc.  All rights reserved."
  24 .\" "Use is subject to license terms."
  25 '\" te
  26 .TH sysbench 1 sysbench\-0.4.12
  27 .SH NAME
  28 \fBsysbench\fP
  29 \- A system-level benchmarking tool
  30 .SH SYNOPSIS
  31 .br
  32 \fB/usr/benchmarks/sysbench/bin/sysbench\fP
  33 [general-options]... [\fB\--test=<test-name>\fP] [test-options]... command
  34 .SH DESCRIPTION
  35
  36 The
  37 \fBsysbench\fP
  38 program is a a modular, cross-platform and multi-threaded benchmark tool for evaluating OS parameters that are important for a system running a database under intensive load.
  39
  40 The idea of this benchmark suite is to quickly get an impression about system performance without setting up complex database benchmarks or even without installing a database at all.
  41
  42 Current features allow testing of the following system parameters:
  43
  44     * file I/O performance
  45     * scheduler performance
  46     * memory allocation and transfer speed
  47     * POSIX threads implementation performance
  48     * database server performance (OLTP benchmark)
  49
  50 Full documentation can be found at the project home page: http://sysbench.sourceforge.net/
  51
  52 .SH OPTIONS
  53
  54 The following general options are supported:
  55   --num-threads=N            number of threads to use [1]
  56   --max-requests=N           limit for total number of requests [10000]
  57   --max-time=N               limit for total execution time in seconds [0]
  58   --thread-stack-size=SIZE   size of stack per thread [32K]
  59   --init-rng=[on|off]        initialize random number generator [off]
  60   --test=STRING              test to run
  61   --debug=[on|off]           print more debugging info [off]
  62   --validate=[on|off]        perform validation checks where possible [off]
  63   --help=[on|off]            print help and exit
  64   --version=[on|off]         print version and exit
  65
  66 The compiled-in tests are:
  67   fileio - File I/O test
  68   cpu - CPU performance test
  69   memory - Memory functions speed test
  70   threads - Threads subsystem performance test
  71   mutex - Mutex performance test
  72   oltp - OLTP test
  73
  74
  75 .\" Begin Sun update
  76 .SH "ATTRIBUTES"
  77 .PP
  78 See \fBattributes\fR(5)
  79 for descriptions of the following attributes:
  80 .sp
  81 .TS
  82 tab(\a) allbox;
  83 cw(2.750000i)| cw(2.750000i)
  84 lw(2.750000i)| lw(2.750000i).
  85 ATTRIBUTE TYPE\aATTRIBUTE VALUE
  86 Availability\abenchmark/sysbench
  87 Interface stability\aUncommitted
  88 .TE
  89 .sp
  90 .\" End Sun update
  91
  92 .SH SEE ALSO
  93
  94 \fBfilebench\fP(1),
  95 .SH AUTHORS
  96  Terminator <jimmyzhou@users.sourceforge.net>
  97  Gautam Iyer <gi1242@users.sourceforge.net>
  98  Marc Schoechlin" <mschoechlin@users.sourceforge.net>
  99 .SH NOTES
 100 Source for Sysbench is available on http://sourceforge.net/projects/sysbench/