]> git.sur5r.net Git - bacula/docs/blobdiff - docs/manuals/en/main/fileset.tex
Tweak doc text
[bacula/docs] / docs / manuals / en / main / fileset.tex
index 282b224dc8169acc579e3e29db3b276034bffc52..7eea8e740bac73452b1fd6c701104d521d756e16 100644 (file)
@@ -29,8 +29,8 @@ On most modern Win32 machines, you can edit the conf files with {\bf
 notebook} and choose output encoding UTF-8.
 
 To ensure that Bacula configuration files can be correctly read including
-foreign characters the {bf LANG} environment variable
-must end in {\bf .UTF-8}. An full example is {\bf en\_US.UTF-8}. The
+foreign characters the {\bf LANG} environment variable
+must end in {\bf .UTF-8}. A full example is {\bf en\_US.UTF-8}. The
 exact syntax may vary a bit from OS to OS, and exactly how you define
 it will also vary.
 
@@ -303,12 +303,10 @@ The options letters specified are used when running a {\bf Backup Level=Full}
 with BaseJobs. The options letters are the same than in the \textbf{verify=}
 option below.
 
-\item[accurate=\lt{}options\gt{}] 
-\index[dir]{accurate}
-\index[dir]{Directive!accurate}
-   The options letters specified are used  when running a {\bf Backup
-   Level=Incremental/Differential} in Accurate mode. The options
-   letters are the same than in the \textbf{verify=} option below.  
+\item[accurate=\lt{}options\gt{}] \index[dir]{accurate}
+  \index[dir]{Directive!accurate} The options letters specified are used when
+  running a {\bf Backup Level=Incremental/Differential} in Accurate mode. The
+  options letters are the same than in the \textbf{verify=} option below. 
 
 \item [verify=\lt{}options\gt{}]
 \index[dir]{verify}
@@ -354,6 +352,10 @@ option below.
 
       \item {\bf 1}
       compare the SHA1 signature  
+
+      \item {\bf A}
+      Only for Accurate option, it allows to always backup the file
+
       \end{description}
 
    A useful set of general options on the {\bf Level=Catalog}  or {\bf
@@ -515,9 +517,9 @@ Change: 2005-11-06 12:36:48.000000000 +0100
    ndbm.  The default is {\bf no}, so no checks are made for sparse files.
    You may specify {\bf sparse=yes} even on files that are not sparse file.
    No harm will be done, but there will be a small additional overhead to
-   check for buffers of all zero, and a small additional amount of space on
-   the output archive will be used to save the seek address of each
-   non-zero record read.
+   check for buffers of all zero, and if there is a 32K block of all zeros
+   (see below), that block will become a hole in the file, which 
+   may not be desirable if the original file was not a sparse file.
 
    {\bf Restrictions:} Bacula reads files in 32K buffers.  If the whole
    buffer is zero, it will be treated as a sparse block and not written to
@@ -545,6 +547,9 @@ Change: 2005-11-06 12:36:48.000000000 +0100
    benchmark the difference or set sparse for only those files that are
    really sparse.
 
+   You probably should not use this option on files or raw disk devices
+   that are not really sparse files (i.e. have holes in them).
+
 \label{readfifo}
 \item [readfifo=yes\vb{}no]
 \index[dir]{readfifo}
@@ -881,7 +886,7 @@ Change: 2005-11-06 12:36:48.000000000 +0100
    filesystem type.  The permitted filesystem-type names are:
 
    ext2, jfs, ntfs, proc, reiserfs, xfs, usbdevfs, sysfs, smbfs,
-   iso9660.  For ext3 systems, use ext2.
+   iso9660.
 
    You may have multiple Fstype directives, and thus permit matching
    of multiple filesystem types within a single Options resource.  If
@@ -1269,7 +1274,7 @@ without any options, but all files in those directories with the extensions
 {\bf .o} and {\bf .exe} will be excluded. 
 
 Let's say that you now want to exclude the directory /tmp. The simplest way
-to do so is to add an exclude directive that lists /tmp.  The example
+to do so is to add an Exclude directive that lists /tmp.  The example
 above would then become:
 
 \footnotesize 
@@ -1302,11 +1307,11 @@ FileSet {
 
 
 You can add wild-cards to the File directives listed in the Exclude
-directory, but you need to take care because if you exclude a directory,
+directive, but you need to take care because if you exclude a directory,
 it and all files and directories below it will also be excluded.
 
-Now lets take a slight variation on the above and suppose
-you want to save all your whole filesystem except {\bf /tmp}. 
+Now let's make a slight variation on the above and suppose
+you want to save all your filesystems except {\bf /tmp}.
 The problem that comes up is that Bacula will not normally
 cross from one filesystem to another.
 Doing a {\bf df} command, you get the following output: 
@@ -1830,7 +1835,7 @@ FileSet {
   Include {
     File = /home/xxx/test
     Options {
-       regex = ".*\.c$"
+       regex = ".*\\.c$"
     }
   }
 }
@@ -1846,4 +1851,5 @@ estimate job=<any-job-name> listing client=<desired-client> fileset=Test
 \end{verbatim}
 \normalsize
 
-to give you a listing of all files that match.
+to give you a listing of all files that match.  In the above
+example, it should be only files with names ending in  {\bf .c}.