1WBOX(1)                     General Commands Manual                    WBOX(1)
2
3
4

NAME

6       wbox - HTTP testing tool and configuration-less HTTP server
7

SYNOPSIS

9       wbox <url> [ options ]
10       wbox servermode webroot <path> [serverport <portnumber> (def 8081)]
11

DESCRIPTION

13       wbox  aims to help you having fun while testing HTTP related stuff. You
14       can use it to perform many tasks, including the following:
15
16       - Benchmarking how much time it takes to generate content for your  web
17       application.
18
19       - Web server and web application stressing.
20
21       -  Testing virtual domains configuration without the need to alter your
22       local resolver.
23
24       - Use it as a configuration-less HTTP server to share files!
25

OPTIONS

27       <number>
28              Stop after <number> requests
29
30       compr  Send Accept-Encoding: gzip,deflate in request
31
32       showhdr
33              Show the HTTP reply header
34
35       dump   Show the HTTP reply header + body
36
37       silent Don't show status lines
38
39       head   Use the HEAD method instead of GET
40
41       http10 Use HTTP/1.0 instead of HTTP/1.1
42
43       close  Close the connection after reading few bytes
44
45       host <hostname>
46              Use <hostname> as Host: field in HTTP request
47
48       timesplit
49              Show transfer times for different data chunks
50
51       wait <number>
52              Wait <number> seconds between requests. Default 1.
53
54       clients <number>
55              Spawn <number> concurrent clients (via fork()).
56
57       referer <url>
58              Send the specified referer header.
59
60       cookie <name> <val>
61              Set cookie name=val, can be used multiple times.
62
63       maxclients <number>
64              Max concurrent clients in server mode (default 20).
65
66       -h or --help
67              Show this help.
68
69       -v     Show version.
70

USAGE EXAMPLES

72       wbox wikipedia.org                  (simplest, basic usage)
73
74       wbox wikipedia.org 3 compr wait 0   (three  requests,  compression,  no
75       delay)
76
77       wbox wikipedia.org 1 showhdr silent (just show the HTTP reply header)
78
79       wbox wikipedia.org timesplit        (show splitted time information)
80
81       wbox 1.2.3.4 host example.domain    (test a virtual domain at 1.2.3.4)
82
83       wbox    servermode    webroot    /tmp/mydocuments     (Try    it   with
84       http://127.0.0.1:8081)
85

TUTORIAL

87       Wbox is trivial to use but, in order to understand better what wbox  is
88       and  how  to  use  it,  you  may  want  to read the TUTORIAL inside the
89       /usr/share/doc/wbox/ directory.
90

AUTHOR

92       wbox was written by Salvatore 'antirez' Sanfilippo <antirez@gmail.com>.
93
94       This manual page was written by Alberto Furia <straluna@email.it>,  for
95       the Debian project (and may be used by others).
96
97
98
99                               December 10, 2009                       WBOX(1)
Impressum