home | help
DAVIX-HTTP(1)			HTTP Request tool		   DAVIX-HTTP(1)

NAME
     davix-http - HTTP query tool based on libdavix

SYNOPSIS
	      davix-http [options]... url

DESCRIPTION
     davix-http is a tool using libdavix for HTTP query executions
     It can be used to interact with a RESTful webservices.

     See libdavix(3) for details.

OPTIONS
     Request Options:

       --data
	  Content of the request

       --request, -X
	  Request method to use (ex : GET, PUT, PROPFIND, etc..)

     Common Options:

       --debug
	  Debug mode

       --header, -H
	  Add a header field to the request (eg: -H "Depth: 1" )

       --help, -h
	  Display this help message

       --metalink OPT
	  Metalink support. (OPT=failover[default]|no)

       --module, -P PLUGIN_NAME
	  Load a plugin or profile by name

       --redirection OPT
	  Transparent redirection support. (OPT=yes[default]|no)

       --proxy, -x URL
	  SOCKS5 proxy server URL. (ex: socks5://login:pass@socks.example.org)

       --trace
	  Traces specific scope(s), options include:
	     file - Davix file interface
	     posix - Davix POSIX interface
	     xml - XML parser output
	     ssl - SSL and certs details
	     header - HTTP queries headers
	     body - HTTP bodies
	     chain - IO chains info
	     core - Config and misc info
	     grid - Misc info from 3rd parties
	     socket - Socket info
	     locks - WebDAV locking info
	     all - Traces everything

       --version
	  Display version

     Security Options:

       --capath CA_path
	  Add an additional certificate authority directory

       --cert, -E cred_path
	  Client Certificate in PEM format

       --key priv_path
	  Private key in PEM format

       --insecure, -k
	  Disable SSL credential checks

       --userlogin
	  User login for login/password authentication

       --userpass
	  User password for login/password authentication

       --s3secretkey
	  AWS S3 authentication: secret key

       --s3accesskey
	  AWS S3 authentication: access key

       --s3region
	  AWS S3 authentication: region

       --s3token
	  AWS S3 security token - used along with STS temporary credentials

       --s3alternate
	  Specify this flag if you need to use a path-based S3 URL

       --azurekey
	  Azure authentication key

EXAMPLES
      Execute a GET Query in HTTP
	     davix-http http://example.org/

      Execute a HEAD Query in HTTP + TLS with User auth
	     davix-http -X HEAD https://login:password@example.org

      Execute a PUT Query with S3 over https and a basic content
	     davix-http -X PUT s3s://bucket.example.org/mifile -d "Hello World"

SEE ALSO
     libdavix(3),davix-ls(1),davix-get(1),davix-put(1),

LINKS
     http://dmc.web.cern.ch/projects/davix/home

AUTHORS
     Adrien Devresse <adrien.devresse@cern.ch>, IT-SDC-ID, CERN

davix			       $Date: 2014/05/24 $		   DAVIX-HTTP(1)

home | help