foreword.rst 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
  1. .. include:: global.rst.inc
  2. .. _foreward:
  3. Foreword
  4. ========
  5. Features
  6. --------
  7. Space efficient storage
  8. Variable block size `deduplication`_ is used to reduce the number of bytes
  9. stored by detecting redundant data. Each file is split into a number of
  10. variable length chunks and only chunks that have never been seen before
  11. are compressed and added to the repository.
  12. Optional data encryption
  13. All data can be protected using 256-bit AES_ encryption and data integrity
  14. and authenticity is verified using `HMAC-SHA256`_.
  15. Off-site backups
  16. |project_name| can store data on any remote host accessible over SSH as
  17. long as |project_name| is installed.
  18. Backups mountable as filesystems
  19. Backup archives are :ref:`mountable <usage_attic_mount>` as
  20. `userspace filesystems`_ for easy backup verification and restores.
  21. Terminology
  22. -----------
  23. .. _deduplication_def:
  24. Deduplication
  25. Deduplication is a technique for improving storage utilization by
  26. eliminating redundant data.
  27. .. _archive_def:
  28. Archive
  29. An archive is a collection of files along with metadata that include file
  30. permissions, directory structure and various file attributes.
  31. Since each archive in a repository must have a unique name a good naming
  32. convention is ``hostname-YYYY-MM-DD``.
  33. .. _repository_def:
  34. Repository
  35. A repository is a filesystem directory storing data from zero or more
  36. archives. The data in a repository is both deduplicated and
  37. optionally encrypted making it both efficient and safe. Repositories are
  38. created using :ref:`attic_init` and the contents can be listed using
  39. :ref:`attic_list`.
  40. Key file
  41. When a repository is initialized a key file containing a password
  42. protected encryption key is created. It is vital to keep this file safe
  43. since the repository data is totally inaccessible without it.