restic-dump(1)

1restic backup(1)                                              restic backup(1)
2
3
4

NAME

6       restic-dump - Print a backed-up file to stdout
7
8
9

SYNOPSIS

11       restic dump [flags] snapshotID file
12
13
14

DESCRIPTION

16       The "dump" command extracts files from a snapshot from the repository.
17       If a single file is selected, it prints its contents to stdout. Folders
18       are output as a tar (default) or zip file containing the contents of
19       the specified folder.  Pass "/" as file name to dump the whole snapshot
20       as an archive file.
21
22
23       The special snapshot "latest" can be used to use the latest snapshot in
24       the repository.
25
26
27

EXIT STATUS

29       Exit status is 0 if the command was successful, and non-zero if there
30       was any error.
31
32
33

OPTIONS

35       -a, --archive="tar"
36           set archive format as "tar" or "zip"
37
38
39       -h, --help[=false]
40           help for dump
41
42
43       -H, --host=[]
44           only consider snapshots for this host when the snapshot ID is
45       "latest" (can be specified multiple times)
46
47
48       --path=[]
49           only consider snapshots which include this (absolute) path for
50       snapshot ID "latest"
51
52
53       --tag=[]
54           only consider snapshots which include this taglist for snapshot ID
55       "latest"
56
57
58

OPTIONS INHERITED FROM PARENT COMMANDS

60       --cacert=[]
61           file to load root certificates from (default: use system
62       certificates)
63
64
65       --cache-dir=""
66           set the cache directory. (default: use system default cache
67       directory)
68
69
70       --cleanup-cache[=false]
71           auto remove old cache directories
72
73
74       --json[=false]
75           set output mode to JSON for commands that support it
76
77
78       --key-hint=""
79           key ID of key to try decrypting first (default: $RESTIC_KEY_HINT)
80
81
82       --limit-download=0
83           limits downloads to a maximum rate in KiB/s. (default: unlimited)
84
85
86       --limit-upload=0
87           limits uploads to a maximum rate in KiB/s. (default: unlimited)
88
89
90       --no-cache[=false]
91           do not use a local cache
92
93
94       --no-lock[=false]
95           do not lock the repository, this allows some operations on
96       read-only repositories
97
98
99       -o, --option=[]
100           set extended option (key=value, can be specified multiple times)
101
102
103       --password-command=""
104           shell command to obtain the repository password from (default:
105       $RESTIC_PASSWORD_COMMAND)
106
107
108       -p, --password-file=""
109           file to read the repository password from (default:
110       $RESTIC_PASSWORD_FILE)
111
112
113       -q, --quiet[=false]
114           do not output comprehensive progress report
115
116
117       -r, --repo=""
118           repository to backup to or restore from (default:
119       $RESTIC_REPOSITORY)
120
121
122       --repository-file=""
123           file to read the repository location from (default:
124       $RESTIC_REPOSITORY_FILE)
125
126
127       --tls-client-cert=""
128           path to a file containing PEM encoded TLS client certificate and
129       private key
130
131
132       -v, --verbose[=0]
133           be verbose (specify multiple times or a level using --verbose=n,
134       max level/times is 3)
135
136
137

NAME

SYNOPSIS

DESCRIPTION

EXIT STATUS

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO