'\" t
.\" ** The above line should force tbl to be a preprocessor **
.\" Man page for tentacle
.\"
.pc
.TH TENTACLE_CLIENT 1 "2010-05-11" "0.2.0" "Client file transfer protocol"
.SH NAME
tentacle_client \- a client file transfer protocol
.SH SYNOPSIS
.\" The help command line
.B tentacle_client
<options>
.B Tentacle 
is a client/server file transfer protocol that aims to be: 
.TS
tab (@);
l l.
-@Executable programs or shell commands
-@System calls (functions provided by the kernel)
-@Library calls (functions within program libraries)
.TE

Tentacle was created to replace more complex tools like SCP and FTP for simple file transfer/retrieval, and switch from authentication mechanisms like .netrc, interactive logins and SSH keys to X.509 certificates. Simple password authentication over a SSL secured connection is supported too. 

The client and server (TCP port 41121) are designed to be run from the command line or called from a shell script, and no configuration files are needed.

Tentacle is now the default file transfer method for Pandora FMS and Babel Enterprise.

Tentacle is implemented in Perl and ANSI C (Windows platforms included).

You can download it and get more information at the official Sourceforge website http://tentacled.sourceforge.net/. 

.SH OPTIONS

.HP
Tentacle Client options : 
.br
.B -a
.I address
.B :
Server address (default 127.0.0.1).
.br
.B -c :
Enable SSL without a client certificate.
.br
.B -e
.I cert
.B :
OpenSSL certificate file. Enables SSL.
.br
.B -f
.I ca
.B :
Verify that the peer certificate is signed by a ca.
.br
.B -g :
Get files from the server.
.br
.B -h : 
Show help.
.br
.B -k
.I key 
.B :
OpenSSL private key file.
.br
.B -p
.I port
.B :
Server port (default 41121).
.br
.B -q :
Quiet. Do now print error messages.
.br
.B -r
.I number
.B :
Number of retries for network operations (default 3).
.br
.B -t
.I time
.B :
Time-out for network operations in seconds (default 1s).
.br
.B -v :
Be verbose.
.br
.B -w :
Prompt for OpenSSL private key password.
.br
.B -x
.I pwd
.B :
Server password.
.br
.P
.HP

.SH EXAMPLES
.TP
.BI tentacle_client\ \-a \ 192.168.1.1 \ \-v \ /bin/bash
Simple file transfer with maximum file size set to 1MB
.TP
.BI tentacle_client\ \-a \ 192.168.1.1 \ \-x \ password \ \-v \ /bin/bash
Simple file transfer with password authentication (not secure)
.TP
.BI tentacle_client\ \-a \ 192.168.1.1 \ \-x \ password \ \-e \ cert.pem \ \-k \ key.pem \ \-v \ /bin/bash
Secure file transfer with client certificate and password authentication

.SH NOTES
Tentacle requires Perl 5.8 or higher to works

.SH SEE ALSO
tentacle_server(1), pandora_server(1), pandora_agent(1)