torhost.1

.Dd May 9, 2018
.Dt TORHOST 1
.Os
.Sh NAME
.Nm torhost
.Nd An anonymous short term file-hosting utility.
.Sh SYNOPSIS
.Nm
.Op Fl kdr
.Op Fl p Ar port
.Op Fl c Ar port
.Op Fl P Ar password
.Ar file
.Sh DESCRIPTION
.Pp
Torhost generates an ephemeral Tor Hidden Service, allowing a user to easily host a single file anonymously without involving third parties for storage.
.Lp
The following options are available:
.Bl -tag -width indent
.It Fl p -port
Specify the port to host the hidden service on (default: 80).
.It Fl c -controlport
Specify control port of already running Tor instance (default: start new Tor instance).
.It Fl P -password
Specify control password of already running Tor instance (default: none).
.It Fl k -keepalive
Keep listening for additional network connections; do not exit after the file has been uploaded once.
.It Fl r -raw
Transfer raw bytes (no http headers)
.It Fl d -debug
Enable debugging information.
.El
.Sh EXAMPLES
The following is an example usage of 
.Nm
.Pp
.Dl $ torhost foo
.Pp
This should yield output similar to:
.Pp
.Dl Starting Tor...
.Dl Hosting file at kjnfkjngfkdgnkfgnkdfgjn.onion
.Dl Press Control-C to abort file hosting.
.Pp
At this stage someone may connect to kjnfkjngfkdgnkfgnkdfgjn.onion with the TorBrowser to download the file. They could also use Tor as a SOCKS proxy and use a utility like netcat or curl to download.
.Sh SEE ALSO
.Xr tor 1 ,
.Xr torsocks 1 ,
.Xr nc 1 ,
.Xr curl 1
.Sh BUGS
To file a bug report, please visit:
.Dl https://github.com/DaylightingSociety/TorHost