Author image Bhavesh Merugureddy
and 1 contributors

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