htcopy man page

htcopy — HTTP client with LCGDM extensions


htcopy [options] [source] [destination]


htcopy is a HTTP client that implements some extensions of the protocol used by the HTTP/DAV front-end of LCGDM. The command is designed to work without user interaction.

It allows to copy from local to remote, from remote to local, and it can also trigger third party copies.

It supports multiple streams for uploads and downloads, improving the performance of the transfer.

Source / Destination

Both the source and/or the destination can be a local path or a HTTP URL. Depending on the combination, it will do an upload, a download, or trigger a third-party copy. Local copies are not supported.



Shows the command help.


Enable the verbose mode. It can be specified more than once (-vvv) to increase the verbosity.

-l/--log <log file>

Specified into which file the extended output (as HTTP headers) must be printed.

-n/--stream-number <number of streams>

Number of streams to use.

-b, --buffer-size <buffer size>

Internal buffer size.

-E/--user-cert <user certificate>

The path to the user certificate in PEM format.

--user-key <user private key>

The user private key in PEM format, if the user certificate doesn't include it.

--key-pass <private key password>

Allows to pass the private key password as an argument.

--ca-path <CA path>

Use the certificate directory to verify the remote certificate.

--ca-bundle <CA file>

Use the certificate file to verify the remote certificate.


Do no check the peer certificate.


05 December 2011 HTTP client with LCGDM extensions