wbox(1) [debian man page]

WBOX(1) 						      General Commands Manual							   WBOX(1)

NAME

       wbox - 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).

								 December 10, 2009							   WBOX(1)

HTTP::Request(3)					User Contributed Perl Documentation					  HTTP::Request(3)

NAME

       HTTP::Request - HTTP style request message

SYNOPSIS

	require HTTP::Request;
	$request = HTTP::Request->new(GET => 'http://www.example.com/');

       and usually used like this:

	$ua = LWP::UserAgent->new;
	$response = $ua->request($request);

DESCRIPTION

       "HTTP::Request" is a class encapsulating HTTP style requests, consisting of a request line, some headers, and a content body. Note that the
       LWP library uses HTTP style requests even for non-HTTP protocols.  Instances of this class are usually passed to the request() method of an
       "LWP::UserAgent" object.

       "HTTP::Request" is a subclass of "HTTP::Message" and therefore inherits its methods.  The following additional methods are available:

       $r = HTTP::Request->new( $method, $uri )
       $r = HTTP::Request->new( $method, $uri, $header )
       $r = HTTP::Request->new( $method, $uri, $header, $content )
	   Constructs a new "HTTP::Request" object describing a request on the object $uri using method $method.  The $method argument must be a
	   string.  The $uri argument can be either a string, or a reference to a "URI" object.  The optional $header argument should be a
	   reference to an "HTTP::Headers" object or a plain array reference of key/value pairs.  The optional $content argument should be a
	   string of bytes.

       $r = HTTP::Request->parse( $str )
	   This constructs a new request object by parsing the given string.

       $r->method
       $r->method( $val )
	   This is used to get/set the method attribute.  The method should be a short string like "GET", "HEAD", "PUT" or "POST".

       $r->uri
       $r->uri( $val )
	   This is used to get/set the uri attribute.  The $val can be a reference to a URI object or a plain string.  If a string is given, then
	   it should be parseable as an absolute URI.

       $r->header( $field )
       $r->header( $field => $value )
	   This is used to get/set header values and it is inherited from "HTTP::Headers" via "HTTP::Message".	See HTTP::Headers for details and
	   other similar methods that can be used to access the headers.

       $r->accept_decodable
	   This will set the "Accept-Encoding" header to the list of encodings that decoded_content() can decode.

       $r->content
       $r->content( $bytes )
	   This is used to get/set the content and it is inherited from the "HTTP::Message" base class.  See HTTP::Message for details and other
	   methods that can be used to access the content.

	   Note that the content should be a string of bytes.  Strings in perl can contain characters outside the range of a byte.  The "Encode"
	   module can be used to turn such strings into a string of bytes.

       $r->as_string
       $r->as_string( $eol )
	   Method returning a textual representation of the request.

SEE ALSO

       HTTP::Headers, HTTP::Message, HTTP::Request::Common, HTTP::Response

COPYRIGHT

       Copyright 1995-2004 Gisle Aas.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.12.1							    2009-06-15							  HTTP::Request(3)