TENTACLE_CLIENT(1)

🌸 TENTACLE_CLIENT(1) β€” the client file transfer protocol page, bestie edition 🌸

okay so welcome to the manual for tentacle_client, from the TENTACLE_CLIENT manual section 1, aka the "Client file transfer protocol" page. This is the client half of Tentacle, and yes we're doing this whole thing together, grab a snack πŸ“


✨ NAME ✨

tentacle_client β€” a client file transfer protocol πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

tentacle_client <options>

Tentacle is a client/server file transfer protocol that aims to be:

  • Executable programs or shell commands
  • System calls (functions provided by the kernel)
  • Library calls (functions within program libraries)

πŸ‘‘ DESCRIPTION πŸ‘‘

so here's the lore: Tentacle was created to replace more complex tools like SCP and FTP for simple file transfer/retrieval, and to switch from authentication mechanisms like .netrc, interactive logins and SSH keys over to X.509 certificates. Simple password authentication over a SSL secured connection is supported too, so you have options, queen.

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 β€” literally none, we love a low-maintenance icon ✨

Tentacle is now the default file transfer method for Pandora FMS and Babel Enterprise. Main character energy fr fr.

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/ 🫢


πŸ’… OPTIONS πŸ’…

Tentacle Client options, one by one, no skips:

  • -a address β€” Server address (default 127.0.0.1). The classic "who am I even talking to" setting.
  • -c β€” Enable SSL without a client certificate. Security, but make it casual.
  • -e cert β€” OpenSSL certificate file. Enables SSL. Show them your papers πŸ“œ
  • -f ca β€” Verify that the peer certificate is signed by a ca. Trust but verify, bestie.
  • -g β€” Get files from the server. (Otherwise you're the one sending.)
  • -h β€” Show help. Your best friend when you're lost πŸ™ˆ
  • -k key β€” OpenSSL private key file.
  • -p port β€” Server port (default 41121).
  • -q β€” Quiet. Do now print error messages. (Yes, that's exactly what it says β€” silence, but at what cost 😭)
  • -r number β€” Number of retries for network operations (default 3).
  • -t time β€” Time-out for network operations in seconds (default 1s).
  • -v β€” Be verbose. Spill the tea, tell me everything πŸ«–
  • -w β€” Prompt for OpenSSL private key password.
  • -x pwd β€” Server password.

🌈 EXAMPLES 🌈

here's how it actually looks in the wild:

tentacle_client -a 192.168.1.1 -v /bin/bash

Simple file transfer with maximum file size set to 1MB


tentacle_client -a 192.168.1.1 -x password -v /bin/bash

Simple file transfer with password authentication (not secure)

not secure, they said it, not me. read that part twice πŸ’€

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

see? glow-up achieved. certified AND passworded. iconic. ✨


πŸŽ€ NOTES πŸŽ€

Tentacle requires Perl 5.8 or higher to works πŸ‘‘ (their words, and honestly, valid.)


πŸ¦„ SEE ALSO πŸ¦„

tentacle_server(1), pandora_server(1), pandora_agent(1)

go read those next, iykyk πŸ’œ


and that's the whole page, bestie!! this was version 0.2.0, dated 2010-05-11 β€” a vintage queen from the TENTACLE_CLIENT(1) manual, and she still slays. mwah πŸ’–βœ¨πŸŽ€