NAME

wsutil - a GRNOC webservice testing utility.

SYNOPSIS

 This is a handy little script to help diagnose a webservice and provide 
 timing of the various stages between initiating a request and actually 
 getting the results back. It offers support for customizing everything 
 that the GRNOC::WebService::Client does.

 Usage:

 wsutil  -U <url> [options]
   or
 wsutil  -S <service_name> 
            [-c <service_cache_file> | -n <name_services>] [options]

 Options:

 -m              which method to run on the remote service. This defaults to 
 --method        "help" if not given.  This will be given as 
                 "method=<input>" when actually calling the remote service.


 -a              what args to pass to the remote service. This should be 
 --args          in the form "foo=1&bar=2&biz=3"


 -u              username to authenticate to the service with. If this is 
 --username      given you will be prompted for a password.


 -P              password for service authentication. If a username is 
 --password      provided but no password, the user will be interactively 
                 prompted for a password.


 -r              realm to use. This is required for basic auth and ignored for 
 --realm         CoSign auth.


 -t              timeout in seconds to use for the request.
 --timeout


 -p              use POST instead of GET
 --post          This is a boolean field and does not require an argument.


 -k              enable keepalives
 --keepalive     This is a boolean field and does not require an argument.


 -o              pass raw output from the service instead of trying to 
 --raw           decode it as json This is a boolean field and does not 
                 require an argument. 


 -l              path to cookie file location. If given this will use any 
                 cookies in the file when authenticating to a service and 
                 also save them to this file when done. If not given 
                 cookies are maintained only for the current run.

                 It is probably prudent to make sure that the cookies that 
                 are generated using your own credentials are cleaned up 
                 afterwards or at least not made publicly available.


 -c              service cache file (in case of specifying -S Service Name)
 --servicecache  This file should be in the same format as the grnoc proxy 
                 cronjob creates from the name service.


 -n              name service lookup URL (in case of specifying -S 
 --nameservice   Service Name)    


 -X              do not print the results of the webservice call
 --noresult      This is a boolean field and does not require an argument.


 -b              Takes a numerical argument. Do a batch of requests 
 --batch         instead of a single request. The numerical argument
                 is the number of requests sent. When doing a batch,
                 the individual responses are not displayed (see -X).
                 Instead call turn-around information is printed 
                 and a summary is printed after all the requests
                 have been sent.


 -s              Silent. Do not print responses (see -X) when doing a 
 --silent        single request timing information and summary when 
                 doing a batch of requests.


 -d              Takes a numerical argument. When sending a batch of 
 --delay         requests (see -b), pause for that many microseconds
                 between each request. Without delay options, batch
                 requests are sent as fast as possible


 -h              show this message
 --help