changes.rst 32 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802
  1. Changelog
  2. =========
  3. Version 0.30.0
  4. --------------
  5. Compatibility notes:
  6. - you may need to use -v (or --info) more often to actually see output emitted
  7. at INFO log level (because it is suppressed at the default WARNING log level).
  8. See the "general" section in the usage docs.
  9. - for borg create, you need --list (additionally to -v) to see the long file
  10. list (was needed so you can have e.g. --stats alone without the long list)
  11. - see below about BORG_DELETE_I_KNOW_WHAT_I_AM_DOING (was:
  12. BORG_CHECK_I_KNOW_WHAT_I_AM_DOING)
  13. Bug fixes:
  14. - fix crash when using borg create --dry-run --keep-tag-files, #570
  15. - make sure teardown with cleanup happens for Cache and RepositoryCache,
  16. avoiding leftover locks and TEMP dir contents, #285 (partially), #548
  17. - fix locking KeyError, partial fix for #502
  18. - log stats consistently, #526
  19. - add abbreviated weekday to timestamp format, fixes #496
  20. - strip whitespace when loading exclusions from file
  21. - unset LD_LIBRARY_PATH before invoking ssh, fixes strange OpenSSL library
  22. version warning when using the borg binary, #514
  23. - add some error handling/fallback for C library loading, #494
  24. - added BORG_DELETE_I_KNOW_WHAT_I_AM_DOING for check in "borg delete", #503
  25. - remove unused "repair" rpc method name
  26. New features:
  27. - borg create: implement exclusions using regular expression patterns.
  28. - borg create: implement inclusions using patterns.
  29. - borg extract: support patterns, #361
  30. - support different styles for patterns:
  31. - fnmatch (`fm:` prefix, default when omitted), like borg <= 0.29.
  32. - shell (`sh:` prefix) with `*` not matching directory separators and
  33. `**/` matching 0..n directories
  34. - path prefix (`pp:` prefix, for unifying borg create pp1 pp2 into the
  35. patterns system), semantics like in borg <= 0.29
  36. - regular expression (`re:`), new!
  37. - --progress option for borg upgrade (#291) and borg delete <archive>
  38. - update progress indication more often (e.g. for borg create within big
  39. files or for borg check repo), #500
  40. - finer chunker granularity for items metadata stream, #547, #487
  41. - borg create --list now used (additionally to -v) to enable the verbose
  42. file list output
  43. - display borg version below tracebacks, #532
  44. Other changes:
  45. - hashtable size (and thus: RAM and disk consumption) follows a growth policy:
  46. grows fast while small, grows slower when getting bigger, #527
  47. - Vagrantfile: use pyinstaller 3.1 to build binaries, freebsd sqlite3 fix,
  48. fixes #569
  49. - no separate binaries for centos6 any more because the generic linux binaries
  50. also work on centos6 (or in general: on systems with a slightly older glibc
  51. than debian7
  52. - dev environment: require virtualenv<14.0 so we get a py32 compatible pip
  53. - docs:
  54. - add space-saving chunks.archive.d trick to FAQ
  55. - important: clarify -v and log levels in usage -> general, please read!
  56. - sphinx configuration: create a simple man page from usage docs
  57. - add a repo server setup example
  58. - disable unneeded SSH features in authorized_keys examples for security.
  59. - borg prune only knows "--keep-within" and not "--within"
  60. - add gource video to resources docs, #507
  61. - add netbsd install instructions
  62. - authors: make it more clear what refers to borg and what to attic
  63. - document standalone binary requirements, #499
  64. - rephrase the mailing list section
  65. - development docs: run build_api and build_usage before tagging release
  66. - internals docs: hash table max. load factor is 0.75 now
  67. - markup, typo, grammar, phrasing, clarifications and other fixes.
  68. - add gcc gcc-c++ to redhat/fedora/corora install docs, fixes #583
  69. Version 0.29.0
  70. --------------
  71. Compatibility notes:
  72. - when upgrading to 0.29.0 you need to upgrade client as well as server
  73. installations due to the locking and commandline interface changes otherwise
  74. you'll get an error msg about a RPC protocol mismatch or a wrong commandline
  75. option.
  76. if you run a server that needs to support both old and new clients, it is
  77. suggested that you have a "borg-0.28.2" and a "borg-0.29.0" command.
  78. clients then can choose via e.g. "borg --remote-path=borg-0.29.0 ...".
  79. - the default waiting time for a lock changed from infinity to 1 second for a
  80. better interactive user experience. if the repo you want to access is
  81. currently locked, borg will now terminate after 1s with an error message.
  82. if you have scripts that shall wait for the lock for a longer time, use
  83. --lock-wait N (with N being the maximum wait time in seconds).
  84. Bug fixes:
  85. - hash table tuning (better chosen hashtable load factor 0.75 and prime initial
  86. size of 1031 gave ~1000x speedup in some scenarios)
  87. - avoid creation of an orphan lock for one case, #285
  88. - --keep-tag-files: fix file mode and multiple tag files in one directory, #432
  89. - fixes for "borg upgrade" (attic repo converter), #466
  90. - remove --progress isatty magic (and also --no-progress option) again, #476
  91. - borg init: display proper repo URL
  92. - fix format of umask in help pages, #463
  93. New features:
  94. - implement --lock-wait, support timeout for UpgradableLock, #210
  95. - implement borg break-lock command, #157
  96. - include system info below traceback, #324
  97. - sane remote logging, remote stderr, #461:
  98. - remote log output: intercept it and log it via local logging system,
  99. with "Remote: " prefixed to message. log remote tracebacks.
  100. - remote stderr: output it to local stderr with "Remote: " prefixed.
  101. - add --debug and --info (same as --verbose) to set the log level of the
  102. builtin logging configuration (which otherwise defaults to warning), #426
  103. note: there are few messages emitted at DEBUG level currently.
  104. - optionally configure logging via env var BORG_LOGGING_CONF
  105. - add --filter option for status characters: e.g. to show only the added
  106. or modified files (and also errors), use "borg create -v --filter=AME ...".
  107. - more progress indicators, #394
  108. - use ISO-8601 date and time format, #375
  109. - "borg check --prefix" to restrict archive checking to that name prefix, #206
  110. Other changes:
  111. - hashindex_add C implementation (speed up cache re-sync for new archives)
  112. - increase FUSE read_size to 1024 (speed up metadata operations)
  113. - check/delete/prune --save-space: free unused segments quickly, #239
  114. - increase rpc protocol version to 2 (see also Compatibility notes), #458
  115. - silence borg by default (via default log level WARNING)
  116. - get rid of C compiler warnings, #391
  117. - upgrade OS X FUSE to 3.0.9 on the OS X binary build system
  118. - use python 3.5.1 to build binaries
  119. - docs:
  120. - new mailing list borgbackup@python.org, #468
  121. - readthedocs: color and logo improvements
  122. - load coverage icons over SSL (avoids mixed content)
  123. - more precise binary installation steps
  124. - update release procedure docs about OS X FUSE
  125. - FAQ entry about unexpected 'A' status for unchanged file(s), #403
  126. - add docs about 'E' file status
  127. - add "borg upgrade" docs, #464
  128. - add developer docs about output and logging
  129. - clarify encryption, add note about client-side encryption
  130. - add resources section, with videos, talks, presentations, #149
  131. - Borg moved to Arch Linux [community]
  132. - fix wrong installation instructions for archlinux
  133. Version 0.28.2
  134. --------------
  135. New features:
  136. - borg create --exclude-if-present TAGFILE - exclude directories that have the
  137. given file from the backup. You can additionally give --keep-tag-files to
  138. preserve just the directory roots and the tag-files (but not backup other
  139. directory contents), #395, attic #128, attic #142
  140. Other changes:
  141. - do not create docs sources at build time (just have them in the repo),
  142. completely remove have_cython() hack, do not use the "mock" library at build
  143. time, #384
  144. - avoid hidden import, make it easier for PyInstaller, easier fix for #218
  145. - docs:
  146. - add description of item flags / status output, fixes #402
  147. - explain how to regenerate usage and API files (build_api or
  148. build_usage) and when to commit usage files directly into git, #384
  149. - minor install docs improvements
  150. Version 0.28.1
  151. --------------
  152. Bug fixes:
  153. - do not try to build api / usage docs for production install,
  154. fixes unexpected "mock" build dependency, #384
  155. Other changes:
  156. - avoid using msgpack.packb at import time
  157. - fix formatting issue in changes.rst
  158. - fix build on readthedocs
  159. Version 0.28.0
  160. --------------
  161. Compatibility notes:
  162. - changed return codes (exit codes), see docs. in short:
  163. old: 0 = ok, 1 = error. now: 0 = ok, 1 = warning, 2 = error
  164. New features:
  165. - refactor return codes (exit codes), fixes #61
  166. - add --show-rc option enable "terminating with X status, rc N" output, fixes 58, #351
  167. - borg create backups atime and ctime additionally to mtime, fixes #317
  168. - extract: support atime additionally to mtime
  169. - FUSE: support ctime and atime additionally to mtime
  170. - support borg --version
  171. - emit a warning if we have a slow msgpack installed
  172. - borg list --prefix=thishostname- REPO, fixes #205
  173. - Debug commands (do not use except if you know what you do: debug-get-obj,
  174. debug-put-obj, debug-delete-obj, debug-dump-archive-items.
  175. Bug fixes:
  176. - setup.py: fix bug related to BORG_LZ4_PREFIX processing
  177. - fix "check" for repos that have incomplete chunks, fixes #364
  178. - borg mount: fix unlocking of repository at umount time, fixes #331
  179. - fix reading files without touching their atime, #334
  180. - non-ascii ACL fixes for Linux, FreeBSD and OS X, #277
  181. - fix acl_use_local_uid_gid() and add a test for it, attic #359
  182. - borg upgrade: do not upgrade repositories in place by default, #299
  183. - fix cascading failure with the index conversion code, #269
  184. - borg check: implement 'cmdline' archive metadata value decoding, #311
  185. - fix RobustUnpacker, it missed some metadata keys (new atime and ctime keys
  186. were missing, but also bsdflags). add check for unknown metadata keys.
  187. - create from stdin: also save atime, ctime (cosmetic)
  188. - use default_notty=False for confirmations, fixes #345
  189. - vagrant: fix msgpack installation on centos, fixes #342
  190. - deal with unicode errors for symlinks in same way as for regular files and
  191. have a helpful warning message about how to fix wrong locale setup, fixes #382
  192. - add ACL keys the RobustUnpacker must know about
  193. Other changes:
  194. - improve file size displays, more flexible size formatters
  195. - explicitly commit to the units standard, #289
  196. - archiver: add E status (means that an error occurred when processing this
  197. (single) item
  198. - do binary releases via "github releases", closes #214
  199. - create: use -x and --one-file-system (was: --do-not-cross-mountpoints), #296
  200. - a lot of changes related to using "logging" module and screen output, #233
  201. - show progress display if on a tty, output more progress information, #303
  202. - factor out status output so it is consistent, fix surrogates removal,
  203. maybe fixes #309
  204. - move away from RawConfigParser to ConfigParser
  205. - archive checker: better error logging, give chunk_id and sequence numbers
  206. (can be used together with borg debug-dump-archive-items).
  207. - do not mention the deprecated passphrase mode
  208. - emit a deprecation warning for --compression N (giving a just a number)
  209. - misc .coverragerc fixes (and coverage measurement improvements), fixes #319
  210. - refactor confirmation code, reduce code duplication, add tests
  211. - prettier error messages, fixes #307, #57
  212. - tests:
  213. - add a test to find disk-full issues, #327
  214. - travis: also run tests on Python 3.5
  215. - travis: use tox -r so it rebuilds the tox environments
  216. - test the generated pyinstaller-based binary by archiver unit tests, #215
  217. - vagrant: tests: announce whether fakeroot is used or not
  218. - vagrant: add vagrant user to fuse group for debianoid systems also
  219. - vagrant: llfuse install on darwin needs pkgconfig installed
  220. - vagrant: use pyinstaller from develop branch, fixes #336
  221. - benchmarks: test create, extract, list, delete, info, check, help, fixes #146
  222. - benchmarks: test with both the binary and the python code
  223. - archiver tests: test with both the binary and the python code, fixes #215
  224. - make basic test more robust
  225. - docs:
  226. - moved docs to borgbackup.readthedocs.org, #155
  227. - a lot of fixes and improvements, use mobile-friendly RTD standard theme
  228. - use zlib,6 compression in some examples, fixes #275
  229. - add missing rename usage to docs, closes #279
  230. - include the help offered by borg help <topic> in the usage docs, fixes #293
  231. - include a list of major changes compared to attic into README, fixes #224
  232. - add OS X install instructions, #197
  233. - more details about the release process, #260
  234. - fix linux glibc requirement (binaries built on debian7 now)
  235. - build: move usage and API generation to setup.py
  236. - update docs about return codes, #61
  237. - remove api docs (too much breakage on rtd)
  238. - borgbackup install + basics presentation (asciinema)
  239. - describe the current style guide in documentation
  240. - add section about debug commands
  241. - warn about not running out of space
  242. - add example for rename
  243. - improve chunker params docs, fixes #362
  244. - minor development docs update
  245. Version 0.27.0
  246. --------------
  247. New features:
  248. - "borg upgrade" command - attic -> borg one time converter / migration, #21
  249. - temporary hack to avoid using lots of disk space for chunks.archive.d, #235:
  250. To use it: rm -rf chunks.archive.d ; touch chunks.archive.d
  251. - respect XDG_CACHE_HOME, attic #181
  252. - add support for arbitrary SSH commands, attic #99
  253. - borg delete --cache-only REPO (only delete cache, not REPO), attic #123
  254. Bug fixes:
  255. - use Debian 7 (wheezy) to build pyinstaller borgbackup binaries, fixes slow
  256. down observed when running the Centos6-built binary on Ubuntu, #222
  257. - do not crash on empty lock.roster, fixes #232
  258. - fix multiple issues with the cache config version check, #234
  259. - fix segment entry header size check, attic #352
  260. plus other error handling improvements / code deduplication there.
  261. - always give segment and offset in repo IntegrityErrors
  262. Other changes:
  263. - stop producing binary wheels, remove docs about it, #147
  264. - docs:
  265. - add warning about prune
  266. - generate usage include files only as needed
  267. - development docs: add Vagrant section
  268. - update / improve / reformat FAQ
  269. - hint to single-file pyinstaller binaries from README
  270. Version 0.26.1
  271. --------------
  272. This is a minor update, just docs and new pyinstaller binaries.
  273. - docs update about python and binary requirements
  274. - better docs for --read-special, fix #220
  275. - re-built the binaries, fix #218 and #213 (glibc version issue)
  276. - update web site about single-file pyinstaller binaries
  277. Note: if you did a python-based installation, there is no need to upgrade.
  278. Version 0.26.0
  279. --------------
  280. New features:
  281. - Faster cache sync (do all in one pass, remove tar/compression stuff), #163
  282. - BORG_REPO env var to specify the default repo, #168
  283. - read special files as if they were regular files, #79
  284. - implement borg create --dry-run, attic issue #267
  285. - Normalize paths before pattern matching on OS X, #143
  286. - support OpenBSD and NetBSD (except xattrs/ACLs)
  287. - support / run tests on Python 3.5
  288. Bug fixes:
  289. - borg mount repo: use absolute path, attic #200, attic #137
  290. - chunker: use off_t to get 64bit on 32bit platform, #178
  291. - initialize chunker fd to -1, so it's not equal to STDIN_FILENO (0)
  292. - fix reaction to "no" answer at delete repo prompt, #182
  293. - setup.py: detect lz4.h header file location
  294. - to support python < 3.2.4, add less buggy argparse lib from 3.2.6 (#194)
  295. - fix for obtaining ``char *`` from temporary Python value (old code causes
  296. a compile error on Mint 17.2)
  297. - llfuse 0.41 install troubles on some platforms, require < 0.41
  298. (UnicodeDecodeError exception due to non-ascii llfuse setup.py)
  299. - cython code: add some int types to get rid of unspecific python add /
  300. subtract operations (avoid ``undefined symbol FPE_``... error on some platforms)
  301. - fix verbose mode display of stdin backup
  302. - extract: warn if a include pattern never matched, fixes #209,
  303. implement counters for Include/ExcludePatterns
  304. - archive names with slashes are invalid, attic issue #180
  305. - chunker: add a check whether the POSIX_FADV_DONTNEED constant is defined -
  306. fixes building on OpenBSD.
  307. Other changes:
  308. - detect inconsistency / corruption / hash collision, #170
  309. - replace versioneer with setuptools_scm, #106
  310. - docs:
  311. - pkg-config is needed for llfuse installation
  312. - be more clear about pruning, attic issue #132
  313. - unit tests:
  314. - xattr: ignore security.selinux attribute showing up
  315. - ext3 seems to need a bit more space for a sparse file
  316. - do not test lzma level 9 compression (avoid MemoryError)
  317. - work around strange mtime granularity issue on netbsd, fixes #204
  318. - ignore st_rdev if file is not a block/char device, fixes #203
  319. - stay away from the setgid and sticky mode bits
  320. - use Vagrant to do easy cross-platform testing (#196), currently:
  321. - Debian 7 "wheezy" 32bit, Debian 8 "jessie" 64bit
  322. - Ubuntu 12.04 32bit, Ubuntu 14.04 64bit
  323. - Centos 7 64bit
  324. - FreeBSD 10.2 64bit
  325. - OpenBSD 5.7 64bit
  326. - NetBSD 6.1.5 64bit
  327. - Darwin (OS X Yosemite)
  328. Version 0.25.0
  329. --------------
  330. Compatibility notes:
  331. - lz4 compression library (liblz4) is a new requirement (#156)
  332. - the new compression code is very compatible: as long as you stay with zlib
  333. compression, older borg releases will still be able to read data from a
  334. repo/archive made with the new code (note: this is not the case for the
  335. default "none" compression, use "zlib,0" if you want a "no compression" mode
  336. that can be read by older borg). Also the new code is able to read repos and
  337. archives made with older borg versions (for all zlib levels 0..9).
  338. Deprecations:
  339. - --compression N (with N being a number, as in 0.24) is deprecated.
  340. We keep the --compression 0..9 for now to not break scripts, but it is
  341. deprecated and will be removed later, so better fix your scripts now:
  342. --compression 0 (as in 0.24) is the same as --compression zlib,0 (now).
  343. BUT: if you do not want compression, you rather want --compression none
  344. (which is the default).
  345. --compression 1 (in 0.24) is the same as --compression zlib,1 (now)
  346. --compression 9 (in 0.24) is the same as --compression zlib,9 (now)
  347. New features:
  348. - create --compression none (default, means: do not compress, just pass through
  349. data "as is". this is more efficient than zlib level 0 as used in borg 0.24)
  350. - create --compression lz4 (super-fast, but not very high compression)
  351. - create --compression zlib,N (slower, higher compression, default for N is 6)
  352. - create --compression lzma,N (slowest, highest compression, default N is 6)
  353. - honor the nodump flag (UF_NODUMP) and do not backup such items
  354. - list --short just outputs a simple list of the files/directories in an archive
  355. Bug fixes:
  356. - fixed --chunker-params parameter order confusion / malfunction, fixes #154
  357. - close fds of segments we delete (during compaction)
  358. - close files which fell out the lrucache
  359. - fadvise DONTNEED now is only called for the byte range actually read, not for
  360. the whole file, fixes #158.
  361. - fix issue with negative "all archives" size, fixes #165
  362. - restore_xattrs: ignore if setxattr fails with EACCES, fixes #162
  363. Other changes:
  364. - remove fakeroot requirement for tests, tests run faster without fakeroot
  365. (test setup does not fail any more without fakeroot, so you can run with or
  366. without fakeroot), fixes #151 and #91.
  367. - more tests for archiver
  368. - recover_segment(): don't assume we have an fd for segment
  369. - lrucache refactoring / cleanup, add dispose function, py.test tests
  370. - generalize hashindex code for any key length (less hardcoding)
  371. - lock roster: catch file not found in remove() method and ignore it
  372. - travis CI: use requirements file
  373. - improved docs:
  374. - replace hack for llfuse with proper solution (install libfuse-dev)
  375. - update docs about compression
  376. - update development docs about fakeroot
  377. - internals: add some words about lock files / locking system
  378. - support: mention BountySource and for what it can be used
  379. - theme: use a lighter green
  380. - add pypi, wheel, dist package based install docs
  381. - split install docs into system-specific preparations and generic instructions
  382. Version 0.24.0
  383. --------------
  384. Incompatible changes (compared to 0.23):
  385. - borg now always issues --umask NNN option when invoking another borg via ssh
  386. on the repository server. By that, it's making sure it uses the same umask
  387. for remote repos as for local ones. Because of this, you must upgrade both
  388. server and client(s) to 0.24.
  389. - the default umask is 077 now (if you do not specify via --umask) which might
  390. be a different one as you used previously. The default umask avoids that
  391. you accidentally give access permissions for group and/or others to files
  392. created by borg (e.g. the repository).
  393. Deprecations:
  394. - "--encryption passphrase" mode is deprecated, see #85 and #97.
  395. See the new "--encryption repokey" mode for a replacement.
  396. New features:
  397. - borg create --chunker-params ... to configure the chunker, fixes #16
  398. (attic #302, attic #300, and somehow also #41).
  399. This can be used to reduce memory usage caused by chunk management overhead,
  400. so borg does not create a huge chunks index/repo index and eats all your RAM
  401. if you back up lots of data in huge files (like VM disk images).
  402. See docs/misc/create_chunker-params.txt for more information.
  403. - borg info now reports chunk counts in the chunk index.
  404. - borg create --compression 0..9 to select zlib compression level, fixes #66
  405. (attic #295).
  406. - borg init --encryption repokey (to store the encryption key into the repo),
  407. fixes #85
  408. - improve at-end error logging, always log exceptions and set exit_code=1
  409. - LoggedIO: better error checks / exceptions / exception handling
  410. - implement --remote-path to allow non-default-path borg locations, #125
  411. - implement --umask M and use 077 as default umask for better security, #117
  412. - borg check: give a named single archive to it, fixes #139
  413. - cache sync: show progress indication
  414. - cache sync: reimplement the chunk index merging in C
  415. Bug fixes:
  416. - fix segfault that happened for unreadable files (chunker: n needs to be a
  417. signed size_t), #116
  418. - fix the repair mode, #144
  419. - repo delete: add destroy to allowed rpc methods, fixes issue #114
  420. - more compatible repository locking code (based on mkdir), maybe fixes #92
  421. (attic #317, attic #201).
  422. - better Exception msg if no Borg is installed on the remote repo server, #56
  423. - create a RepositoryCache implementation that can cope with >2GiB,
  424. fixes attic #326.
  425. - fix Traceback when running check --repair, attic #232
  426. - clarify help text, fixes #73.
  427. - add help string for --no-files-cache, fixes #140
  428. Other changes:
  429. - improved docs:
  430. - added docs/misc directory for misc. writeups that won't be included
  431. "as is" into the html docs.
  432. - document environment variables and return codes (attic #324, attic #52)
  433. - web site: add related projects, fix web site url, IRC #borgbackup
  434. - Fedora/Fedora-based install instructions added to docs
  435. - Cygwin-based install instructions added to docs
  436. - updated AUTHORS
  437. - add FAQ entries about redundancy / integrity
  438. - clarify that borg extract uses the cwd as extraction target
  439. - update internals doc about chunker params, memory usage and compression
  440. - added docs about development
  441. - add some words about resource usage in general
  442. - document how to backup a raw disk
  443. - add note about how to run borg from virtual env
  444. - add solutions for (ll)fuse installation problems
  445. - document what borg check does, fixes #138
  446. - reorganize borgbackup.github.io sidebar, prev/next at top
  447. - deduplicate and refactor the docs / README.rst
  448. - use borg-tmp as prefix for temporary files / directories
  449. - short prune options without "keep-" are deprecated, do not suggest them
  450. - improved tox configuration
  451. - remove usage of unittest.mock, always use mock from pypi
  452. - use entrypoints instead of scripts, for better use of the wheel format and
  453. modern installs
  454. - add requirements.d/development.txt and modify tox.ini
  455. - use travis-ci for testing based on Linux and (new) OS X
  456. - use coverage.py, pytest-cov and codecov.io for test coverage support
  457. I forgot to list some stuff already implemented in 0.23.0, here they are:
  458. New features:
  459. - efficient archive list from manifest, meaning a big speedup for slow
  460. repo connections and "list <repo>", "delete <repo>", "prune" (attic #242,
  461. attic #167)
  462. - big speedup for chunks cache sync (esp. for slow repo connections), fixes #18
  463. - hashindex: improve error messages
  464. Other changes:
  465. - explicitly specify binary mode to open binary files
  466. - some easy micro optimizations
  467. Version 0.23.0
  468. --------------
  469. Incompatible changes (compared to attic, fork related):
  470. - changed sw name and cli command to "borg", updated docs
  471. - package name (and name in urls) uses "borgbackup" to have less collisions
  472. - changed repo / cache internal magic strings from ATTIC* to BORG*,
  473. changed cache location to .cache/borg/ - this means that it currently won't
  474. accept attic repos (see issue #21 about improving that)
  475. Bug fixes:
  476. - avoid defect python-msgpack releases, fixes attic #171, fixes attic #185
  477. - fix traceback when trying to do unsupported passphrase change, fixes attic #189
  478. - datetime does not like the year 10.000, fixes attic #139
  479. - fix "info" all archives stats, fixes attic #183
  480. - fix parsing with missing microseconds, fixes attic #282
  481. - fix misleading hint the fuse ImportError handler gave, fixes attic #237
  482. - check unpacked data from RPC for tuple type and correct length, fixes attic #127
  483. - fix Repository._active_txn state when lock upgrade fails
  484. - give specific path to xattr.is_enabled(), disable symlink setattr call that
  485. always fails
  486. - fix test setup for 32bit platforms, partial fix for attic #196
  487. - upgraded versioneer, PEP440 compliance, fixes attic #257
  488. New features:
  489. - less memory usage: add global option --no-cache-files
  490. - check --last N (only check the last N archives)
  491. - check: sort archives in reverse time order
  492. - rename repo::oldname newname (rename repository)
  493. - create -v output more informative
  494. - create --progress (backup progress indicator)
  495. - create --timestamp (utc string or reference file/dir)
  496. - create: if "-" is given as path, read binary from stdin
  497. - extract: if --stdout is given, write all extracted binary data to stdout
  498. - extract --sparse (simple sparse file support)
  499. - extra debug information for 'fread failed'
  500. - delete <repo> (deletes whole repo + local cache)
  501. - FUSE: reflect deduplication in allocated blocks
  502. - only allow whitelisted RPC calls in server mode
  503. - normalize source/exclude paths before matching
  504. - use posix_fadvise to not spoil the OS cache, fixes attic #252
  505. - toplevel error handler: show tracebacks for better error analysis
  506. - sigusr1 / sigint handler to print current file infos - attic PR #286
  507. - RPCError: include the exception args we get from remote
  508. Other changes:
  509. - source: misc. cleanups, pep8, style
  510. - docs and faq improvements, fixes, updates
  511. - cleanup crypto.pyx, make it easier to adapt to other AES modes
  512. - do os.fsync like recommended in the python docs
  513. - source: Let chunker optionally work with os-level file descriptor.
  514. - source: Linux: remove duplicate os.fsencode calls
  515. - source: refactor _open_rb code a bit, so it is more consistent / regular
  516. - source: refactor indicator (status) and item processing
  517. - source: use py.test for better testing, flake8 for code style checks
  518. - source: fix tox >=2.0 compatibility (test runner)
  519. - pypi package: add python version classifiers, add FreeBSD to platforms
  520. Attic Changelog
  521. ---------------
  522. Here you can see the full list of changes between each Attic release until Borg
  523. forked from Attic:
  524. Version 0.17
  525. ~~~~~~~~~~~~
  526. (bugfix release, released on X)
  527. - Fix hashindex ARM memory alignment issue (#309)
  528. - Improve hashindex error messages (#298)
  529. Version 0.16
  530. ~~~~~~~~~~~~
  531. (bugfix release, released on May 16, 2015)
  532. - Fix typo preventing the security confirmation prompt from working (#303)
  533. - Improve handling of systems with improperly configured file system encoding (#289)
  534. - Fix "All archives" output for attic info. (#183)
  535. - More user friendly error message when repository key file is not found (#236)
  536. - Fix parsing of iso 8601 timestamps with zero microseconds (#282)
  537. Version 0.15
  538. ~~~~~~~~~~~~
  539. (bugfix release, released on Apr 15, 2015)
  540. - xattr: Be less strict about unknown/unsupported platforms (#239)
  541. - Reduce repository listing memory usage (#163).
  542. - Fix BrokenPipeError for remote repositories (#233)
  543. - Fix incorrect behavior with two character directory names (#265, #268)
  544. - Require approval before accessing relocated/moved repository (#271)
  545. - Require approval before accessing previously unknown unencrypted repositories (#271)
  546. - Fix issue with hash index files larger than 2GB.
  547. - Fix Python 3.2 compatibility issue with noatime open() (#164)
  548. - Include missing pyx files in dist files (#168)
  549. Version 0.14
  550. ~~~~~~~~~~~~
  551. (feature release, released on Dec 17, 2014)
  552. - Added support for stripping leading path segments (#95)
  553. "attic extract --strip-segments X"
  554. - Add workaround for old Linux systems without acl_extended_file_no_follow (#96)
  555. - Add MacPorts' path to the default openssl search path (#101)
  556. - HashIndex improvements, eliminates unnecessary IO on low memory systems.
  557. - Fix "Number of files" output for attic info. (#124)
  558. - limit create file permissions so files aren't read while restoring
  559. - Fix issue with empty xattr values (#106)
  560. Version 0.13
  561. ~~~~~~~~~~~~
  562. (feature release, released on Jun 29, 2014)
  563. - Fix sporadic "Resource temporarily unavailable" when using remote repositories
  564. - Reduce file cache memory usage (#90)
  565. - Faster AES encryption (utilizing AES-NI when available)
  566. - Experimental Linux, OS X and FreeBSD ACL support (#66)
  567. - Added support for backup and restore of BSDFlags (OSX, FreeBSD) (#56)
  568. - Fix bug where xattrs on symlinks were not correctly restored
  569. - Added cachedir support. CACHEDIR.TAG compatible cache directories
  570. can now be excluded using ``--exclude-caches`` (#74)
  571. - Fix crash on extreme mtime timestamps (year 2400+) (#81)
  572. - Fix Python 3.2 specific lockf issue (EDEADLK)
  573. Version 0.12
  574. ~~~~~~~~~~~~
  575. (feature release, released on April 7, 2014)
  576. - Python 3.4 support (#62)
  577. - Various documentation improvements a new style
  578. - ``attic mount`` now supports mounting an entire repository not only
  579. individual archives (#59)
  580. - Added option to restrict remote repository access to specific path(s):
  581. ``attic serve --restrict-to-path X`` (#51)
  582. - Include "all archives" size information in "--stats" output. (#54)
  583. - Added ``--stats`` option to ``attic delete`` and ``attic prune``
  584. - Fixed bug where ``attic prune`` used UTC instead of the local time zone
  585. when determining which archives to keep.
  586. - Switch to SI units (Power of 1000 instead 1024) when printing file sizes
  587. Version 0.11
  588. ~~~~~~~~~~~~
  589. (feature release, released on March 7, 2014)
  590. - New "check" command for repository consistency checking (#24)
  591. - Documentation improvements
  592. - Fix exception during "attic create" with repeated files (#39)
  593. - New "--exclude-from" option for attic create/extract/verify.
  594. - Improved archive metadata deduplication.
  595. - "attic verify" has been deprecated. Use "attic extract --dry-run" instead.
  596. - "attic prune --hourly|daily|..." has been deprecated.
  597. Use "attic prune --keep-hourly|daily|..." instead.
  598. - Ignore xattr errors during "extract" if not supported by the filesystem. (#46)
  599. Version 0.10
  600. ~~~~~~~~~~~~
  601. (bugfix release, released on Jan 30, 2014)
  602. - Fix deadlock when extracting 0 sized files from remote repositories
  603. - "--exclude" wildcard patterns are now properly applied to the full path
  604. not just the file name part (#5).
  605. - Make source code endianness agnostic (#1)
  606. Version 0.9
  607. ~~~~~~~~~~~
  608. (feature release, released on Jan 23, 2014)
  609. - Remote repository speed and reliability improvements.
  610. - Fix sorting of segment names to ignore NFS left over files. (#17)
  611. - Fix incorrect display of time (#13)
  612. - Improved error handling / reporting. (#12)
  613. - Use fcntl() instead of flock() when locking repository/cache. (#15)
  614. - Let ssh figure out port/user if not specified so we don't override .ssh/config (#9)
  615. - Improved libcrypto path detection (#23).
  616. Version 0.8.1
  617. ~~~~~~~~~~~~~
  618. (bugfix release, released on Oct 4, 2013)
  619. - Fix segmentation fault issue.
  620. Version 0.8
  621. ~~~~~~~~~~~
  622. (feature release, released on Oct 3, 2013)
  623. - Fix xattr issue when backing up sshfs filesystems (#4)
  624. - Fix issue with excessive index file size (#6)
  625. - Support access of read only repositories.
  626. - New syntax to enable repository encryption:
  627. attic init --encryption="none|passphrase|keyfile".
  628. - Detect and abort if repository is older than the cache.
  629. Version 0.7
  630. ~~~~~~~~~~~
  631. (feature release, released on Aug 5, 2013)
  632. - Ported to FreeBSD
  633. - Improved documentation
  634. - Experimental: Archives mountable as fuse filesystems.
  635. - The "user." prefix is no longer stripped from xattrs on Linux
  636. Version 0.6.1
  637. ~~~~~~~~~~~~~
  638. (bugfix release, released on July 19, 2013)
  639. - Fixed an issue where mtime was not always correctly restored.
  640. Version 0.6
  641. ~~~~~~~~~~~
  642. First public release on July 9, 2013