wbox - Man Page
HTTP testing tool and configuration-less HTTP server
Synopsis
wbox <url> [ options ]
wbox servermode webroot <path> [serverport <portnumber> (def 8081)]
Description
wbox aims to help you having fun while testing HTTP related stuff. You can use it to perform many tasks, including the following:
- Benchmarking how much time it takes to generate content for your web application.
- Web server and web application stressing.
- Testing virtual domains configuration without the need to alter your local resolver.
- Use it as a configuration-less HTTP server to share files!
Options
- <number>
Stop after <number> requests
- compr
Send Accept-Encoding: gzip,deflate in request
- showhdr
Show the HTTP reply header
- dump
Show the HTTP reply header + body
- silent
Don't show status lines
- head
Use the HEAD method instead of GET
- http10
Use HTTP/1.0 instead of HTTP/1.1
- close
Close the connection after reading few bytes
- host <hostname>
Use <hostname> as Host: field in HTTP request
- timesplit
Show transfer times for different data chunks
- wait <number>
Wait <number> seconds between requests. Default 1.
- clients <number>
Spawn <number> concurrent clients (via fork()).
- referer <url>
Send the specified referer header.
- cookie <name> <val>
Set cookie name=val, can be used multiple times.
- maxclients <number>
Max concurrent clients in server mode (default 20).
- -h or --help
Show this help.
- -v
Show version.
Usage Examples
wbox wikipedia.org (simplest, basic usage)
wbox wikipedia.org 3 compr wait 0 (three requests, compression, no delay)
wbox wikipedia.org 1 showhdr silent (just show the HTTP reply header)
wbox wikipedia.org timesplit (show splitted time information)
wbox 1.2.3.4 host example.domain (test a virtual domain at 1.2.3.4)
wbox servermode webroot /tmp/mydocuments (Try it with http://127.0.0.1:8081)
Tutorial
Wbox is trivial to use but, in order to understand better what wbox is and how to use it, you may want to read the TUTORIAL inside the /usr/share/doc/wbox/ directory.
Author
wbox was written by Salvatore 'antirez' Sanfilippo <antirez@gmail.com>.
This manual page was written by Alberto Furia <straluna@email.it>, for the Debian project (and may be used by others).