From 1ebd3f0eea63401ca697b57fe7d85cad48df9dbb Mon Sep 17 00:00:00 2001 From: Sebastian Lohff Date: Fri, 27 Apr 2012 04:30:53 +0200 Subject: [PATCH] Extended manpage --- servefile.1 | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/servefile.1 b/servefile.1 index a7dcf3f..b5de9da 100644 --- a/servefile.1 +++ b/servefile.1 @@ -32,6 +32,12 @@ 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. +In \fB--tar\fR mode the given file or directory will be on the fly and on +request packed and, through the HTTP connection, piped to the client. Tar files +will be created only containing the top directory given to servefile, so using +path/to/dir/ as \fIfile/directory\fR argument will create a tar file starting +with the dir/ directory. Symlinks will not be dereferenced. + .SH COMMAND SUMMARY .SS "positional arguments:" .TP @@ -72,6 +78,15 @@ Certfile to use for SSL .TP \fB\-a\fR user:password, \fB\-\-auth\fR user:password Set user and password for HTTP basic authentication +.TP +\fB\-t\fR, \fB\-\-tar\fR +Enable on the fly tar creation for given file or +directory. Note: Download continuation will not be +available. +.TP +\fB\-c\fR method, \fB\-\-compression\fR method +Set compression method, only in combination with +\fB\-\-tar\fR. Can be one of none, gzip, bzip2. .SH EXAMPLES Serving a single file with SSL and HTTP Basic auth: .IP @@ -87,5 +102,9 @@ Uploading file foo as bar to servefile via command line: curl \-X POST http://ip:port/bar \-d @foo wget http://ip:port/bar \-\-post-file=foo .PP +serving a on the fly generated tar.gz file of a directory: +.IP +servefile --tar -c gzip path/to/dir +.PP .SH AUTHOR servefile is developed by Sebastian Lohff