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"      set archive format as "tar" or "zip"
36
37
38       -h, --help[=false]      help for dump
39
40
41       -H, --host=[]      only consider snapshots for this host when the snap‐
42       shot ID is "latest" (can be specified multiple times)
43
44
45       --path=[]      only consider snapshots which  include  this  (absolute)
46       path for snapshot ID "latest"
47
48
49       --tag=[]       only  consider  snapshots which include this taglist for
50       snapshot ID "latest"
51
52
53

OPTIONS INHERITED FROM PARENT COMMANDS

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

NAME

SYNOPSIS

DESCRIPTION

EXIT STATUS

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO