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

FreeBSD Manual Pages

  
 
  

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

NAME
       restic-prune - Remove unneeded data from	the repository

SYNOPSIS
       restic prune [flags]

DESCRIPTION
       The  "prune" command checks the repository and removes data that	is not
       referenced and therefore	not needed any more.

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
       -n, --dry-run[=false]	  do not modify	 the  repository,  just	 print
       what would be done

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

       --max-repack-size=""	  stop after repacking this much data in total
       (allowed	suffixes for size: k/K,	m/M, g/G, t/T)

       --max-unused="5%"      tolerate given limit of  unused  data  (absolute
       value  in  bytes	 with suffixes k/K, m/M, g/G, t/T, a value in %	or the
       word 'unlimited')

       --repack-cacheable-only[=false]	     only  repack  packs   which   are
       cacheable

       --repack-small[=false]	    repack pack	files below 80%	of target pack
       size

       --repack-smaller-than=""	     pack below-limit packfiles	(allowed  suf-
       fixes: k/K, m/M)

       --repack-uncompressed[=false]	  repack all uncompressed data

       --unsafe-recover-no-free-space=""       UNSAFE,	READ THE DOCUMENTATION
       BEFORE USING! Try to recover a repository stuck with no free space.  Do
       not use without trying out 'prune --max-repack-size 0' first.

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-prune&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help