From: Kern Sibbald <kern@sibbald.com>
Date: Mon, 18 Jul 2005 17:17:54 +0000 (+0000)
Subject: Update keepatime
X-Git-Tag: Release-1.38.0~288
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=b40949ebe8bbca86f1cbbc58d045df5edd4690cb;p=bacula%2Fdocs

Update keepatime
---

diff --git a/docs/manual/fileset.tex b/docs/manual/fileset.tex
index 8f4cfcf7..c1bd4571 100644
--- a/docs/manual/fileset.tex
+++ b/docs/manual/fileset.tex
@@ -346,8 +346,18 @@ The directives within an Options resource may be one of the following:
    the backup.  This option is not generally recommended as there are very
    few programs that use st\_atime, and the backup overhead is increased
    because of the additional system call necessary to reset the times.
+   However, for some files, such as mailboxes, when Bacula backs up the
+   file, the user will notice that someone (Bacula) has accessed the
+   file. In this, case keepatime can be useful.
    (I'm not sure this works on Win32).
 
+   Note, if you use this feature, when Bacula resets the access time, the
+   change time (st_ctime) will automatically be modified by the system,
+   so on the next incremental job, the file will be backed up even if
+   it has not changed. As a consequence, you will probably also want
+   to use {\bf mtimeonly = yes} as well as keepatime (thanks to
+   Rudolf Cejka for this tip).
+
 \item [wild=\lt{}string\gt{}]
 \index[dir]{wild }
    Specifies a wild-card string to be applied to the filenames and
diff --git a/docs/manual/python.tex b/docs/manual/python.tex
index 0237dd5a..d9aff79c 100644
--- a/docs/manual/python.tex
+++ b/docs/manual/python.tex
@@ -128,6 +128,15 @@ Access to the Bacula variables and methods is done with:
 
      import bacula
 
+The following are the read-only attributes provided by the bacula object.
+\begin{description}
+\item [Name]
+\item [ConfigFile]
+\item [WorkingDir]
+\item [Version] string consisting of "Version  Build-date"
+\end{description}
+
+
 A simple definition of the Bacula Events Class might be the following:
 
 \footnotesize
@@ -220,7 +229,6 @@ The following read-only attributes are available within the Director
 for the {\bf job} object.
 
 \begin{description}
-\item [DirName] The name of the Director daemon.
 \item [Level]
 \item [Type]
 \item [JobId]
@@ -232,9 +240,6 @@ for the {\bf job} object.
 \item [MediaType]
 \item [JobName]
 \item [JobStatus]
-\item [ConfigFile]
-\item [WorkingDir]
-\item [Version] tuple consisting of (Version, Build-date)
 \item [CatalogRes] tuple consisting of (DBName, Address, User,
   Password, Socket, Port, Database Vendor) taken from the Catalog resource 
    for the Job with the exception of Database Vendor, which is