forked from seba/servefile
Added manpage
This commit is contained in:
parent
860e24906c
commit
cc93b6340c
|
|
@ -1 +1,2 @@
|
||||||
include changelog
|
include changelog
|
||||||
|
include servefile.1
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,99 @@
|
||||||
|
.TH SERVEFILE "1" "April 2012" "servefile 0.4.0" "User Commands"
|
||||||
|
|
||||||
|
.SH NAME
|
||||||
|
servefile \- small HTTP-Server for transitional file transfer
|
||||||
|
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.B servefile
|
||||||
|
[\fI\-h\fR\fR] [\fI\-\-version\fR] [\fI\-p PORT\fR] [\fI\-u\fR] [\fI\-s MAX_UPLOAD_SIZE\fR] [\fI\-l\fR]
|
||||||
|
.IP
|
||||||
|
[\fI\-\-ssl\fR] [\fI\-\-key KEY\fR] [\fI\-\-cert CERT\fR] [\fI\-a user:password\fR]
|
||||||
|
\fIfile/directory\fR
|
||||||
|
|
||||||
|
.SH DISCLAIMER
|
||||||
|
Do not use this as a normal webserver. This server is optimized for running
|
||||||
|
a short time and to send files to other people, not for doing performant
|
||||||
|
static file serving.
|
||||||
|
|
||||||
|
.SH DESCRIPTION
|
||||||
|
servefile is a small HTTP-server indented for transitional file transfer
|
||||||
|
mostly in the local network. It aims to make transfer of single files as
|
||||||
|
painless as possible.
|
||||||
|
|
||||||
|
Without any options servefile serves just one file and redirects all HTTP
|
||||||
|
requests to that one file.
|
||||||
|
|
||||||
|
Uploads can be done with curl, wget (see EXAMPLES) or a normal browser.
|
||||||
|
In upload mode with \fI\-u\fR servefile creates a directory and saves all
|
||||||
|
uploads into that directory. When uploading with curl or wget the filename
|
||||||
|
is taken out of the path part of the url used for the upload.
|
||||||
|
|
||||||
|
For SSL support python-openssl (pyssl) needs to be installed. If no key and
|
||||||
|
cert is given, servefile will generate a keypair for you and display its
|
||||||
|
fingerprint.
|
||||||
|
|
||||||
|
.SH COMMAND SUMMARY
|
||||||
|
.SS "positional arguments:"
|
||||||
|
.TP
|
||||||
|
\fIfile/directory\fR
|
||||||
|
file or directory (with \fB\-l\fR or \fB\-u\fR) which should be served or uploaded to
|
||||||
|
.SS "optional arguments:"
|
||||||
|
.TP
|
||||||
|
\fB\-h\fR, \fB\-\-help\fR
|
||||||
|
Show this help message and exit
|
||||||
|
.TP
|
||||||
|
\fB\-\-version\fR
|
||||||
|
Show program's version number and exit
|
||||||
|
.TP
|
||||||
|
\fB\-p\fR PORT, \fB\-\-port\fR PORT
|
||||||
|
Port to listen on
|
||||||
|
.TP
|
||||||
|
\fB\-u\fR, \fB\-\-upload\fR
|
||||||
|
Enable uploads to a given directory
|
||||||
|
.TP
|
||||||
|
\fB\-s\fR MAX_UPLOAD_SIZE, \fB\-\-max\-upload\-size\fR MAX_UPLOAD_SIZE
|
||||||
|
Limit uploadsize in kb. Size modifiers are allowed,
|
||||||
|
e.g. 2G, 12Mb, 1b.
|
||||||
|
.TP
|
||||||
|
\fB\-l\fR, \fB\-\-list\-dir\fR
|
||||||
|
Show directory indexes and allow access to all
|
||||||
|
subdirectories
|
||||||
|
.TP
|
||||||
|
\fB\-\-ssl\fR
|
||||||
|
Enable SSL. If no key/cert is specified one will be
|
||||||
|
generated.
|
||||||
|
.TP
|
||||||
|
\fB\-\-key\fR KEY
|
||||||
|
Keyfile to use for SSL. If no cert is given with
|
||||||
|
\fB\-\-cert\fR the keyfile will also be searched for a cert
|
||||||
|
.TP
|
||||||
|
\fB\-\-cert\fR CERT
|
||||||
|
Certfile to use for SSL
|
||||||
|
.TP
|
||||||
|
\fB\-a\fR user:password, \fB\-\-auth\fR user:password
|
||||||
|
Set user and password for HTTP basic authentication
|
||||||
|
.SH EXAMPLES
|
||||||
|
Serving a single file with SSL and HTTP Basic auth:
|
||||||
|
.PP
|
||||||
|
.Vb 1
|
||||||
|
servefile --ssl --auth foo:bar the_file
|
||||||
|
.Ve
|
||||||
|
.PP
|
||||||
|
Enabling uploads to a directory:
|
||||||
|
.PP
|
||||||
|
.Bv 1
|
||||||
|
servefile -u dir/
|
||||||
|
.Ve
|
||||||
|
.PP
|
||||||
|
Uploading file foo as bar to servefile via command line:
|
||||||
|
.PP
|
||||||
|
.Bv 1
|
||||||
|
curl -X PUT http://ip:port/bar -d @foo
|
||||||
|
curl -X POST http://ip:port/bar -d @foo
|
||||||
|
wget http://ip:port/bar --post-file=foo
|
||||||
|
.Ve
|
||||||
|
.PP
|
||||||
|
.SH AUTHOR
|
||||||
|
servefile is developed by Sebastian Lohff <seba@someserver.de>
|
||||||
|
|
||||||
|
.SH COPYRIGHT
|
||||||
Loading…
Reference in New Issue