浏览代码

Merge pull request #8 from ThomasWaldmann/doc-specialfiles

improve docs about what is preserved and what not
TW 10 年之前
父节点
当前提交
17cb997f3f
共有 1 个文件被更改,包括 19 次插入6 次删除
  1. 19 6
      docs/faq.rst

+ 19 - 6
docs/faq.rst

@@ -25,20 +25,33 @@ Can I backup from multiple servers into a single repository?
     Borg will keep an exclusive lock on the repository while creating
     or deleting archives, which may make *simultaneous* backups fail.
 
-Which file attributes are preserved?
-    The following attributes are preserved:
-
+Which file types, attributes, etc. are preserved?
+    * Directories
+    * Regular files
+    * Hardlinks (considering all files in the same archive)
+    * Symlinks (stored as symlink, the symlink is not followed)
+    * Character and block device files
+    * FIFOs ("named pipes")
     * Name
     * Contents
-    * Hardlinks and symlinks
     * Time of last modification (nanosecond precision with Python >= 3.3)
     * User ID of owner
     * Group ID of owner
-    * Unix Permission
-    * Extended attributes (xattrs)
+    * Unix Mode/Permissions (u/g/o permissions, suid, sgid, sticky)
+    * Extended Attributes (xattrs)
     * Access Control Lists (ACL_) on Linux, OS X and FreeBSD
     * BSD flags on OS X and FreeBSD
 
+Which file types, attributes, etc. are *not* preserved?
+    * UNIX domain sockets (because it does not make sense - they are meaningless
+      without the running process that created them and the process needs to
+      recreate them in any case). So, don't panic if your backup misses a UDS!
+    * The precise on-disk representation of the holes in a sparse file.
+      Archive creation has no special support for sparse files, holes are
+      backed up up as (deduplicated and compressed) runs of zero bytes.
+      Archive extraction has optional support to extract all-zero chunks as
+      holes in a sparse file.
+
 How can I specify the encryption passphrase programmatically?
     The encryption passphrase can be specified programmatically using the
     `BORG_PASSPHRASE` environment variable. This is convenient when setting up