From 3c284e4029eb98472a7e5b53f21ec5394a97285a Mon Sep 17 00:00:00 2001
From: netblue30 <netblue30@yahoo.com>
Date: Fri, 11 Mar 2016 10:33:56 -0500
Subject: file transfer feature

---
 src/man/firejail.txt | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

(limited to 'src/man/firejail.txt')

diff --git a/src/man/firejail.txt b/src/man/firejail.txt
index 56a768614..a53d2d14e 100644
--- a/src/man/firejail.txt
+++ b/src/man/firejail.txt
@@ -8,6 +8,12 @@ Start a sandbox:
 firejail [OPTIONS] [program and arguments]
 .RE
 .PP
+File transfer from an existing sandbox
+.PP
+.RS
+firejail {\-\-ls | \-\-get} dir_or_filename
+.RE
+.PP
 Network traffic shaping for an existing sandbox:
 .PP
 .RS
@@ -392,6 +398,9 @@ $ firejail \-\-list
 .br
 $ firejail \-\-fs.print=3272
 
+.TP
+\fB\-\-get=name|pid filename
+Get a file from sandbox container, see \fBFILE TRANSFER\fR section for more details.
 
 .TP
 \fB\-?\fR, \fB\-\-help\fR
@@ -549,7 +558,11 @@ Security filters, cgroups and cpus configurations are not applied to the process
 
 
 
+.TP
+\fB\-\-ls=name|pid dir_or_filename
+List files in sandbox container, see \fBFILE TRANSFER\fR section for more details.
 
+\fB
 
 .TP
 \fB\-\-list
@@ -1521,6 +1534,54 @@ Example:
 .br
 $ firejail \-\-zsh
 
+.SH FILE TRANSFER
+These features allow the user to inspect the file system container of an existing sandbox
+and transfer files from the container to the host file system.
+
+.TP
+\fB\-\-get=name filename
+Retrieve the container file filename and store it on the host in the current working directory.
+The container is spececified by name (\-\-name option). Full path is needed for filename.
+
+.TP
+\fB\-\-get=pid filename
+Retrieve the container file filename and store it on the host in the current working directory.
+The container is spececified by process ID. Full path is needed for filename.
+
+.TP
+\fB\-\-ls=name dir_or_filename
+List container files.
+The container is spececified by name (\-\-name option).
+Full path is needed for dir_or_filename.
+
+.TP
+\fB\-\-ls=pid dir_or_filename
+List container files.
+The container is spececified by process ID.
+Full path is needed for dir_or_filename.
+
+.TP
+Examples:
+.br
+
+.br
+$ firejail \-\-ls=mybrowser ~/Downloads
+.br
+drwxr-xr-x netblue  netblue         4096 .
+.br
+drwxr-xr-x netblue  netblue         4096 ..
+.br
+-rw-r--r-- netblue  netblue         7847 x11-x305.png
+.br
+-rw-r--r-- netblue  netblue         6800 x11-x642.png
+.br
+-rw-r--r-- netblue  netblue        34139 xpra-clipboard.png
+.br
+
+.br
+$ firejail \-\-get=mybrowser ~/Downloads/xpra-clipboard.png
+
+
 .SH TRAFFIC SHAPING
 Network bandwidth is an expensive resource shared among all sandboxes running on a system.
 Traffic shaping allows the user to increase network performance by controlling
-- 
cgit v1.2.3-70-g09d2