home | help
DAVIX-PUT(1)			  download tool 		    DAVIX-PUT(1)

NAME
     davix-put - Upload tool based on libdavix

SYNOPSIS
	      davix-put [options]... local_file url

DESCRIPTION
     davix-put	is a tool to upload resources to http, Webdav or REST compatible
     services.
     The command supports the protocol Http (http(s)://), WebDav (dav(s)://) and
     S3 (s3(s)://).

     Local resources can either be a single file or a collection.
     In the case of collection, all sub-collections will also be uploaded.

     davix-put is powered by libdavix. See libdavix(3) for details.

OPTIONS
     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 Davix command line tools 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
     Upload local file to a http server
	     davix-put /tmp/file1 http://example.org/dir1/dir2/file1

     Upload a local file to a Grid compatible storage
	     davix-put	  -P	grid	/tmp/file1     davs://grid-storage.exam-
     ple.org/dir1/file1

     Upload a resource to a OAuth 2.0 compatible service
	     davix-put /tmp/file https://example.org/dir1/tmpfile -H "Authoriza-
     tion: Bearer mytoken"

     Upload local directory to a http server
	     davix-put mydir http://example.org/dir1

SEE ALSO
     libdavix(3),davix-put(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-PUT(1)

home | help