From: Nicolas Boichat <nicolas@boichat.ch>
Date: Tue, 18 Oct 2005 12:05:44 +0000 (+0000)
Subject: Update documentation to use new dvd-handler script.
X-Git-Tag: Release-1.38.0~55
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=372d6b60e5bd1b67894560efc591891bb13351b8;p=bacula%2Fdocs

Update documentation to use new dvd-handler script.
---

diff --git a/docs/manual/dvd.tex b/docs/manual/dvd.tex
index 58ca5f7b..5e509e59 100644
--- a/docs/manual/dvd.tex
+++ b/docs/manual/dvd.tex
@@ -17,12 +17,13 @@ the image to a spool directory, then when the Volume reaches
 a certain size or,  at your option, at the end of a Job, Bacula
 will transfer the image from the spool directory to the
 DVD.  The actual work of transferring the image is done
-by a script {\bf dvd-writepart}, and the heart of that
+by a script {\bf dvd-handler}, and the heart of that
 script is a program called {\bf growisofs} which allows
-creating or adding to a DVD ISO filesystem. growisofs is
-normally found in the {\bf dvd+rw-tools} package or rpm.
-You must have it loaded on your system for DVD writing to
-work.
+creating or adding to a DVD ISO filesystem.
+
+You must have {\bf dvd+rw-tools} loaded on your system for DVD writing to
+work. Please note that the original {\bf dvd+rw-tools} package does {\bf NOT}
+work with Bacula. You must apply a patch which can be found in the {\bf patches} directory of Bacula sources.
 
 The fact that Bacula cannot use the OS to write directly
 to the DVD makes the whole process a bit more error prone than
@@ -94,16 +95,16 @@ Device resource.
    and with 0 otherwise, and \%v with the current part filename.
 
    For a DVD, you will most frequently specify the Bacula supplied  {\bf
-   dvd-writepart} script as follows:  
+   dvd-handler} script as follows:  
 
 \footnotesize
 \begin{verbatim}
-  Write Part Command = "/path/dvd-writepart %e %a %v"
+  Write Part Command = "/path/dvd-handler %a write %e %v"
 \end{verbatim}
 \normalsize
 
   Where {\bf /path} is the path to your scripts install directory, and
-  dvd-writepart is the Bacula supplied script file.  
+  dvd-handler is the Bacula supplied script file.  
   This command will already be present, but commented out,
   in the default bacula-sd.conf file. To use it, simply remove
   the comment (\#) symbol.
@@ -117,18 +118,18 @@ Device resource.
    the first part, and with 0 otherwise, and \%v with the current part filename.
 
    For a DVD, you will most frequently specify the Bacula supplied  {\bf
-   dvd-freespace} script as follows:  
+   dvd-handler} script as follows:  
 
 \footnotesize
 \begin{verbatim}
-  Free Space Command = "/path/dvd-freespace %a"
+  Free Space Command = "/path/dvd-handler %a free"
 \end{verbatim}
 \normalsize
 
   Where {\bf /path} is the path to your scripts install directory, and
   dvd-freespace is the Bacula supplied script file.
   If you want to specify your own command, please look at the code in
-  dvd-freespace to see what output Bacula expects from this command.
+  dvd-handler to see what output Bacula expects from this command.
   This command will already be present, but commented out,
   in the default bacula-sd.conf file. To use it, simply remove
   the comment (\#) symbol.
diff --git a/docs/manual/install.tex b/docs/manual/install.tex
index 3825d7b9..6f2ca077 100644
--- a/docs/manual/install.tex
+++ b/docs/manual/install.tex
@@ -100,7 +100,7 @@ depkgs-win32  } \\
 \multicolumn{1}{c| }{X  } \\
  \hline {zlib } & \multicolumn{1}{c| }{- } & \multicolumn{1}{c| }{- } &
 \multicolumn{1}{c| }{X  } \\
- \hline {wxWidgits } & \multicolumn{1}{c| }{- } & \multicolumn{1}{c| }{- } &
+ \hline {wxWidgets } & \multicolumn{1}{c| }{- } & \multicolumn{1}{c| }{- } &
 \multicolumn{1}{c| }{X }
 \\ \hline 
 
diff --git a/docs/manual/requirements.tex b/docs/manual/requirements.tex
index 826f0996..7d2e0744 100644
--- a/docs/manual/requirements.tex
+++ b/docs/manual/requirements.tex
@@ -50,6 +50,10 @@ need them both loaded. On RedHat systems,  the C++ compiler is part of the
 \item If you want to enable command line editing and history, you will  need
    to have /usr/include/termcap.h and either the termcap or the  ncurses library
    loaded (libtermcap-devel or ncurses-devel). 
-\item If you want to use DVD as backup medium, you will need to download  and
-   install the \elink{dvd+rw-tools}{http://fy.chalmers.se/~appro/linux/DVD+RW/}. 
+\item If you want to use DVD as backup medium, you will need to download the
+   \elink{dvd+rw-tools 5.21.4.10.8}{http://fy.chalmers.se/~appro/linux/DVD+RW/},
+   apply the \elink{patch}{http://cvs.sourceforge.net/viewcvs.py/*checkout*/bacula/bacula/patches/dvd+rw-tools-5.21.4.10.8.bacula.patch}
+   to make these tools compatible with Bacula, then compile and install them.
+   Do not use the dvd+rw-tools provided by your distribution, they will not work
+   with Bacula.
 \end{itemize}
diff --git a/docs/manual/storedconf.tex b/docs/manual/storedconf.tex
index 44cf7bfb..92afe9df 100644
--- a/docs/manual/storedconf.tex
+++ b/docs/manual/storedconf.tex
@@ -818,16 +818,16 @@ Bacula version 1.37 and later.
    and with 0 otherwise, and \%v with the current part filename.
 
    For a DVD, you will most frequently specify the Bacula supplied  {\bf
-   dvd-writepart} script as follows:  
+   dvd-handler} script as follows:  
 
 \footnotesize
 \begin{verbatim}
-  Write Part Command = "/path/dvd-writepart %e %a %v"
+  Write Part Command = "/path/dvd-handler %a write %e %v"
 \end{verbatim}
 \normalsize
 
   Where {\bf /path} is the path to your scripts install directory, and
-  dvd-writepart is the Bacula supplied script file.  
+  dvd-handler is the Bacula supplied script file.  
   This command will already be present, but commented out,
   in the default bacula-sd.conf file. To use it, simply remove
   the comment (\#) symbol.
@@ -841,18 +841,18 @@ Bacula version 1.37 and later.
    the first part, and with 0 otherwise, and \%v with the current part filename.
 
    For a DVD, you will most frequently specify the Bacula supplied  {\bf
-   dvd-freespace} script as follows:  
+   dvd-handler} script as follows:  
 
 \footnotesize
 \begin{verbatim}
-  Free Space Command = "/path/dvd-freespace %a"
+  Free Space Command = "/path/dvd-handler %a free"
 \end{verbatim}
 \normalsize
 
   Where {\bf /path} is the path to your scripts install directory, and
-  dvd-freespace is the Bacula supplied script file.
+  dvd-handler is the Bacula supplied script file.
   If you want to specify your own command, please look at the code of
-  dvd-freespace to see what output Bacula expects from this command.
+  dvd-handler to see what output Bacula expects from this command.
   This command will already be present, but commented out,
   in the default bacula-sd.conf file. To use it, simply remove
   the comment (\#) symbol.
@@ -1037,8 +1037,8 @@ Device {
 #  MountCommand = "/bin/mount -t iso9660 -o ro %a %m";
 #  UnmountCommand = "/bin/umount %m";
 #  SpoolDirectory = /tmp/backup;
-#  WritePartCommand = "/etc/bacula/dvd-writepart %e %a %v"
-#  FreeSpaceCommand = "/etc/bacula/dvd-freespace %a"
+#  WritePartCommand = "/etc/bacula/dvd-handler %a write %e %v"
+#  FreeSpaceCommand = "/etc/bacula/dvd-handler %a free"
 #}
 #
 # A very old Exabyte with no end of media detection
diff --git a/docs/manual/version.tex b/docs/manual/version.tex
index 52eea98f..a57e82f2 100644
--- a/docs/manual/version.tex
+++ b/docs/manual/version.tex
@@ -1 +1 @@
-1.37.41 (05 October 2005)
+1.37.41 (16 October 2005)