borg-info.1 3.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107
  1. .\" Man page generated from reStructuredText.
  2. .
  3. .
  4. .nr rst2man-indent-level 0
  5. .
  6. .de1 rstReportMargin
  7. \\$1 \\n[an-margin]
  8. level \\n[rst2man-indent-level]
  9. level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
  10. -
  11. \\n[rst2man-indent0]
  12. \\n[rst2man-indent1]
  13. \\n[rst2man-indent2]
  14. ..
  15. .de1 INDENT
  16. .\" .rstReportMargin pre:
  17. . RS \\$1
  18. . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
  19. . nr rst2man-indent-level +1
  20. .\" .rstReportMargin post:
  21. ..
  22. .de UNINDENT
  23. . RE
  24. .\" indent \\n[an-margin]
  25. .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
  26. .nr rst2man-indent-level -1
  27. .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
  28. .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
  29. ..
  30. .TH "BORG-INFO" 1 "2022-07-03" "" "borg backup tool"
  31. .SH NAME
  32. borg-info \- Show archive details such as disk space used
  33. .SH SYNOPSIS
  34. .sp
  35. borg [common options] info [options]
  36. .SH DESCRIPTION
  37. .sp
  38. This command displays detailed information about the specified archive.
  39. .sp
  40. Please note that the deduplicated sizes of the individual archives do not add
  41. up to the deduplicated size of the repository ("all archives"), because the two
  42. are meaning different things:
  43. .sp
  44. This archive / deduplicated size = amount of data stored ONLY for this archive
  45. = unique chunks of this archive.
  46. All archives / deduplicated size = amount of data stored in the repo
  47. = all chunks in the repository.
  48. .sp
  49. Borg archives can only contain a limited amount of file metadata.
  50. The size of an archive relative to this limit depends on a number of factors,
  51. mainly the number of files, the lengths of paths and other metadata stored for files.
  52. This is shown as \fIutilization of maximum supported archive size\fP\&.
  53. .SH OPTIONS
  54. .sp
  55. See \fIborg\-common(1)\fP for common options of Borg commands.
  56. .SS optional arguments
  57. .INDENT 0.0
  58. .TP
  59. .B \-\-json
  60. format output as JSON
  61. .UNINDENT
  62. .SS Archive filters
  63. .INDENT 0.0
  64. .TP
  65. .BI \-a \ GLOB\fR,\fB \ \-\-glob\-archives \ GLOB
  66. only consider archive names matching the glob. sh: rules apply, see "borg help patterns".
  67. .TP
  68. .BI \-\-sort\-by \ KEYS
  69. Comma\-separated list of sorting keys; valid keys are: timestamp, name, id; default is: timestamp
  70. .TP
  71. .BI \-\-first \ N
  72. consider first N archives after other filters were applied
  73. .TP
  74. .BI \-\-last \ N
  75. consider last N archives after other filters were applied
  76. .UNINDENT
  77. .SH EXAMPLES
  78. .INDENT 0.0
  79. .INDENT 3.5
  80. .sp
  81. .nf
  82. .ft C
  83. $ borg info Tuesday2022\-06\-25T20:51:39
  84. Archive name: Tuesday2022\-06\-25T20:51:39
  85. Archive fingerprint: f7dea0788dfc026cc2be1c0f5b94beb4e4084eb3402fc40c38d8719b1bf2d943
  86. Comment:
  87. Hostname: mba2020
  88. Username: tw
  89. Time (start): Sat, 2022\-06\-25 20:51:40
  90. Time (end): Sat, 2022\-06\-25 20:51:40
  91. Duration: 0.03 seconds
  92. Command line: /Users/tw/w/borg\-env/bin/borg \-r path/to/repo create \-\-stats \(aqTuesday{now}\(aq src \-\-progress
  93. Utilization of maximum supported archive size: 0%
  94. Number of files: 244
  95. Original size: 13.80 MB
  96. Deduplicated size: 531 B
  97. .ft P
  98. .fi
  99. .UNINDENT
  100. .UNINDENT
  101. .SH SEE ALSO
  102. .sp
  103. \fIborg\-common(1)\fP, \fIborg\-list(1)\fP, \fIborg\-diff(1)\fP
  104. .SH AUTHOR
  105. The Borg Collective
  106. .\" Generated by docutils manpage writer.
  107. .