Skip to content

Latest commit

 

History

History
63 lines (46 loc) · 2.04 KB

README.md

File metadata and controls

63 lines (46 loc) · 2.04 KB
Raw

URLCONNTEST - C

This project is a simple URL connection tester. It utilises the libcurl library to perform a specified number of HTTP GET requests to the specified URL, and reports back some time performance metrics.
These metrics can be used to determine the connectivity performance to said URL.

Author: Mark Ferris aka cicero-mf

Compiling

If you're on a completely clean system you will need the following installed:

$ sudo apt install git
$ sudo apt install make
$ sudo apt install curl
$ sudo apt install libssl-dev
$ sudo apt install zlib1g-dev

To download and compile and run, run the following commands from a linux shell (tested in ubuntu)

$ git clone https://github.com/cicero-mf/urlconntest.git
$ cd testurl
$ make

The Makefile should download and compile the libcurl library, build and run the testurl program all automatically. If you do not wish to run the program immediately after a build please comment the last line of the MAKEFILE.

Running the Test

The test will run with default options (-url http://www.google.com/ -n 5) and no extra headers if none are specified.

$ ./testurl -url http://www.google.com/ -n 5 -verboseOn

Arguments

A list of arguments that can be provided to the test in addition to the URL are given below.

  • -url <url> => URL for the test
  • -H "Header name: Header-value" => specify extra HTTP headers to add to the requests. Note: can be used multiple times.
  • -n <integer> => Number of sample HTTP requests to make during the test
  • -verbose<On/Off> => verboseOn prints progress and raw metrics from each test, verboseOff or not adding the verbose argument will suppress any extra run-time prints

Output

When the test finishes, it prints the following list of metrics as listed below - timings in microseconds.

  • URLTEST
  • <url under test>
  • <IP address of HTTP server>
  • <HTTP response code>
  • <median of the name lookup time>
  • <median of the connect time>
  • <median of the start transfer time>
  • <median of total time>