summaryrefslogtreecommitdiff
path: root/docs/loadbars.txt
blob: 1cb9764b58eb9a71de8d6b98bc1fc0de2f721b18 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
NAME
    httpbench - Simple HTTP benchmarking tool

SYNOPSIS
    httpbench -u <url or urllist.txt> -d sec -c concurrent -r rps [-t ms]
    [-e expected]

DESCRIPTION
    HTTP Bench is a small program for Linux, UNIX and a like written in C
    which can be used to benchmark HTTP servers. For more infos please
    consult the project website.

  Arguments
   Mandatory
    "-u url or urllist.txt"
                An URL to benchmark if argument begins with http:// or
                https:// or a path to a text file containing a list of all
                HTTP-URLs to request during a benchmark. Each line should
                start with http:// or https://.

    "-d seconds"
                Duration of the benchmark in seconds. E.g. 300 for a five
                minutes benchmark.

    "-c concurrent"
                Number of cuncurrent threads used by the benchmark.

    "-r rps"    Requests per second wanted for the benchmark.

   Optional
    "-t timeoutms"
                Timeout in milliseconds for each request. This timeout will
                actually not interrupt any requests. It's there just for
                statistical reasons. E.g. how many requests take longer than
                x milliseconds?

    "-e expectedresponsestr"
                The expected response of a request. E.g. all requests should
                contain HTML in its reponse. All responses not matching are
                counted and reported.

  EXAMPLES
    "httpbench -u mylist.txt -d 60 -c 10 -r 1000"
                Iterates over each url in mylist.txt with 10 cuncurrent
                threads for 60 seconds and tries to reach 1000 requests per
                second. Each curl failure will be reported at the end of the
                test (total count and total %).

    "httpbench -u http://www.example.com -d 300 -c 1000 -r 10000 -t 20 -e
    "Hello World""
                Benchmarks the single URL http://www.example.com with 1000
                cuncurrent threads for 5 minutes and tries to reach 10000
                requests per second. Each request which takes longer than 20
                milliseconds will be reported at the end of the test (total
                count and total %) and each request which does not contain
                "Hello World" in its response string will also be reported
                (total count and total %). The curl errors will also be
                reported.

LICENSE
    See package description or project website.

AUTHOR
    Paul Buetow - <http://httpbench.buetow.org>