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 snapshot
42       ID "latest" is given (can be specified multiple times)
43
44
45       --path=[]      only consider snapshots including this (absolute)  path,
46       when snapshot ID "latest" is given (can be specified multiple times)
47
48
49       --tag=[]       only  consider  snapshots  including tag[,tag,...], when
50       snapshot ID "latest" is given (can be specified multiple times)
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       --compression=auto      compression mode (only available for repository
67       format version 2), one of (auto|off|max)
68
69
70       --insecure-tls[=false]      skip TLS certificate verification when con‐
71       necting to the repository (insecure)
72
73
74       --json[=false]      set output mode to JSON for commands  that  support
75       it
76
77
78       --key-hint=""       key  ID  of  key  to try decrypting first (default:
79       $RESTIC_KEY_HINT)
80
81
82       --limit-download=0      limits downloads to a maximum  rate  in  KiB/s.
83       (default: unlimited)
84
85
86       --limit-upload=0       limits  uploads to a maximum rate in KiB/s. (de‐
87       fault: unlimited)
88
89
90       --no-cache[=false]      do not use a local cache
91
92
93       --no-lock[=false]      do not lock the repository, this allows some op‐
94       erations on read-only repositories
95
96
97       -o,  --option=[]       set extended option (key=value, can be specified
98       multiple times)
99
100
101       --pack-size=0      set target pack size in MiB, created pack files  may
102       be larger (default: $RESTIC_PACK_SIZE)
103
104
105       --password-command=""      shell command to obtain the repository pass‐
106       word from (default: $RESTIC_PASSWORD_COMMAND)
107
108
109       -p, --password-file=""      file to read the repository  password  from
110       (default: $RESTIC_PASSWORD_FILE)
111
112
113       -q, --quiet[=false]      do not output comprehensive progress report
114
115
116       -r,  --repo=""       repository  to backup to or restore from (default:
117       $RESTIC_REPOSITORY)
118
119
120       --repository-file=""      file to read  the  repository  location  from
121       (default: $RESTIC_REPOSITORY_FILE)
122
123
124       --tls-client-cert=""       path  to  a  file containing PEM encoded TLS
125       client certificate and private key
126
127
128       -v, --verbose[=0]      be verbose (specify multiple times  or  a  level
129       using --verbose=n``, max level/times is 2)
130
131
132

NAME

SYNOPSIS

DESCRIPTION

EXIT STATUS

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO