Name

realhttp — execute an HTTP(S) request for a specified url

Synopsis

[ localhost url= realhttp url= item=cgi ]realhttp [url=https://secure.mybc.com:447/index.html item=secure ]
realhttp [url= greppos=success ]
realhttp [url= grepneg=test ]
realhttp

Description

This module is used to execute an HTTP request for a specified url. It utilizes the LWP libraries so it can support HTTPS if the Crypt/SSLeay libraries have been installed on your system.

A query is considered successfull if LWP reports success. There is no method currently implemented to check that the page returned is what would be expected.

This check will only work if you have the LWP::UserAgent perl module installed (see CPAN)

Arguments:

url The url to retrieve.

item The item to report this test as. Defaults to 'http'.

greppos A regular expression which should be found in the contents returned from the server.

grepneg A regular expression which should *NOT* be found in the contents returned from the server.

user A username to supply in basic authentication

pass A password to supply in basic authentication