Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
restic backup(1)					      restic backup(1)

NAME
       restic-dump - Print a backed-up file to stdout

SYNOPSIS
       restic dump [flags] snapshotID file

DESCRIPTION
       The  "dump" command extracts files from a snapshot from the repository.
       If a single file	is selected, it	prints its contents to stdout. Folders
       are output as a tar (default) or	zip file containing  the  contents  of
       the specified folder.  Pass "/" as file name to dump the	whole snapshot
       as an archive file.

       The  special snapshotID "latest"	can be used to use the latest snapshot
       in the repository.

       To include the folder content at	the root of the	archive, you  can  use
       the  "snapshotID:subfolder"  syntax, where "subfolder" is a path	within
       the snapshot.

EXIT STATUS
       Exit status is 0	if the command was successful.	Exit status  is	 1  if
       there  was any error.  Exit status is 10	if the repository does not ex-
       ist.  Exit status is 11 if the repository is already locked.  Exit sta-
       tus is 12 if the	password is incorrect.

OPTIONS
       -a, --archive="tar"	set archive format as "tar" or "zip"

       -h, --help[=false]      help for	dump

       -H, --host=[]	  only consider	snapshots for this host, when snapshot
       ID "latest" is  given  (can  be	specified  multiple  times)  (default:
       $RESTIC_HOST)

       --path=[]       only consider snapshots including this (absolute) path,
       when snapshot ID	"latest" is given (can be  specified  multiple	times,
       snapshots must include all specified paths)

       --tag=[]	      only  consider  snapshots	 including tag[,tag,...], when
       snapshot	ID "latest" is given (can be specified multiple	times)

       -t, --target=""	    write the output to	target path

OPTIONS	INHERITED FROM PARENT COMMANDS
       --cacert=[]	file to	load root certificates from (default: use sys-
       tem certificates	or $RESTIC_CACERT)

       --cache-dir=""	   set the cache directory. (default: use  system  de-
       fault cache directory)

       --cleanup-cache[=false]	    auto remove	old cache directories

       --compression=auto      compression mode	(only available	for repository
       format version 2), one of (auto|off|max)	(default: $RESTIC_COMPRESSION)

       --http-user-agent=""	  set  a http user agent for outgoing http re-
       quests

       --insecure-no-password[=false]	    use	 an  empty  password  for  the
       repository, must	be passed to every restic command (insecure)

       --insecure-tls[=false]	   skip	TLS certificate	verification when con-
       necting to the repository (insecure)

       --json[=false]	    set	 output	mode to	JSON for commands that support
       it

       --key-hint=""	  key ID of key	 to  try  decrypting  first  (default:
       $RESTIC_KEY_HINT)

       --limit-download=0	limits	downloads  to a	maximum	rate in	KiB/s.
       (default: unlimited)

       --limit-upload=0	     limits uploads to a maximum rate in  KiB/s.  (de-
       fault: unlimited)

       --no-cache[=false]      do not use a local cache

       --no-extra-verify[=false]      skip additional verification of data be-
       fore upload (see	documentation)

       --no-lock[=false]      do not lock the repository, this allows some op-
       erations	on read-only repositories

       -o,  --option=[]	      set extended option (key=value, can be specified
       multiple	times)

       --pack-size=0	  set target pack size in MiB, created pack files  may
       be larger (default: $RESTIC_PACK_SIZE)

       --password-command=""	  shell	command	to obtain the repository pass-
       word from (default: $RESTIC_PASSWORD_COMMAND)

       -p,  --password-file=""	     file to read the repository password from
       (default: $RESTIC_PASSWORD_FILE)

       -q, --quiet[=false]	do not output comprehensive progress report

       -r, --repo=""	  repository to	backup to or  restore  from  (default:
       $RESTIC_REPOSITORY)

       --repository-file=""	  file	to  read  the repository location from
       (default: $RESTIC_REPOSITORY_FILE)

       --retry-lock=0s	    retry to lock the  repository  if  it  is  already
       locked, takes a value like 5m or	2h (default: no	retries)

       --stuck-request-timeout=5m0s	  duration  after which	to retry stuck
       requests

       --tls-client-cert=""	 path to a file	 containing  PEM  encoded  TLS
       client certificate and private key (default: $RESTIC_TLS_CLIENT_CERT)

       -v,  --verbose[=0]	be  verbose (specify multiple times or a level
       using --verbose=n``, max	level/times is 2)

SEE ALSO
       restic(1)

generated by restic generate	   Jan 2017		      restic backup(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=restic-dump&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help