Update DVD documentation.

diff --git a/docs/manual/dvd.tex b/docs/manual/dvd.tex
index 442a81f37adc9d0435cb91b82bd2286d7350878b..a212cd5a50f06e308aedf2c90115185fa66af272 100644 (file)
--- a/docs/manual/dvd.tex
+++ b/docs/manual/dvd.tex
@@ -90,15 +90,15 @@ Device resource.
    \index[sd]{Write Part Command  }
    Command that must be executed to write a part to the device. Before the 
    command is executed, \%a is replaced with the Archive Device, \%m with the 
-   Mount Point, \%n with the current part number (0-based), and \%v with the 
-   current part filename.
+   Mount Point, \%e is replaced with 1 if we are writing 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-writepart} script as follows:  
 
 \footnotesize
 \begin{verbatim}
-  Write Part Command = "/path/dvd-writepart %n %a %v"
+  Write Part Command = "/path/dvd-writepart %e %a %v"
 \end{verbatim}
 \normalsize
 
@@ -112,16 +112,16 @@ Device resource.
 \item [Free Space Command = {\it name-string}]
    \index[sd]{Free Space Command  }
    Command that must be executed to check how much free space is left on the 
-   device. Before the command is executed, \%a is replaced with the Archive 
-   Device, \%m with the Mount Point, \%n with the current part number (0-based), 
-   and \%v with the current part filename.
+   device. Before the command is executed,\%a is replaced with the Archive
+   Device, \%m with the Mount Point, \%e is replaced with 1 if we are writing
+   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:  
 
 \footnotesize
 \begin{verbatim}
-  Free Space Command = "/path/dvd-freespace %n %a"
+  Free Space Command = "/path/dvd-freespace %a"
 \end{verbatim}
 \normalsize
 
@@ -185,19 +185,51 @@ The following directives are added to the Director's Job resource.
 \addcontentsline{toc}{subsection}{Other Points}
 
 \begin{itemize}
-\item DVD+RW supports only about 1000 overwrites, so every time you
-   mount the filesystem read/write will count as one write. This can
-   add up quickly, so it is best to mount your DVD+RW filesystem read-only.
-   Bacula does not need the DVD to be mounted read-write, since it uses
-   the raw device for writing.
-\item Reformating DVD+RW 10-20 time can apparently make the medium 
-   unusable. Normally you should not have to format or reformat
-   DVD+RW media. If it is necessary, current versions of growisofs will
-   do so automatically.
-\item If you wish to blank your DVD, use the following:
+\item I had several problems writing to DVD-RWs (this does NOT concern DVD+RW),
+because these media have two writing-modes: {\bf Incremental Sequential} and
+{\bf Restricted Overwrite}. Depending on your device and the media you use,
+one of these modes may not work correctly (e.g. {\bf Incremental Sequential} does
+not work with my NEC DVD-writer and Verbatim DVD-RW).
+
+To retrieve the current mode of a DVD-RW, run:
+\begin{verbatim}
+  dvd+rw-mediainfo /dev/xxx
+\end{verbatim}
+where you replace xxx with your DVD device name.
+
+{\bf Mounted Media} line should give you the information.
+
+To set the device to {\bf Restricted Overwrite} mode, run:
+\begin{verbatim}
+  dvd+rw-format /dev/xxx
+\end{verbatim}
+If you want to set it back to the default {\bf Incremental Sequential} mode, run:
+\begin{verbatim}
+  dvd+rw-format -blank /dev/xxx
+\end{verbatim}
+
+\item Bacula only accepts to write to blank DVDs. To quick blank a DVD+/-RW, run
+this command:
+\begin{verbatim}
+  dd if=/dev/zero bs=1024 count=512 | growisofs -Z /dev/xxx=/dev/fd/0
+\end{verbatim}
+Then, try to mount the device, if it cannot be mounted, it will be considered
+as blank by Bacula, if it can be mounted, try a full blank (see below).
+
+\item If you wish to blank completely a DVD+/-RW, use the following:
 \begin{verbatim}
   growisofs -Z /dev/xxx=/dev/zero
 \end{verbatim}
   where you replace xxx with your DVD device name. However, note that this
   blanks the whole DVD, which takes quite a long time (16 minutes on mine).
+\item DVD+RW and DVD-RW support only about 1000 overwrites (i.e. don't use the
+same medium for years if you don't want to have problems...).
+
+\item Reformating DVD+RW 10-20 time can apparently make the medium 
+   unusable. Normally you should not have to format or reformat
+   DVD+RW media. If it is necessary, current versions of growisofs will
+   do so automatically.
+
+\item For more informations about DVD writing, please look at the
+\elink{dvd+rw-tools homepage}{http://fy.chalmers.se/~appro/linux/DVD+RW/}.
 \end{itemize}

diff --git a/docs/manual/requirements.tex b/docs/manual/requirements.tex
index b3f757e3e3172681f321e6686115e8e0d011f9b0..826f0996f3540bc8562af02c1ec66913311610a6 100644 (file)
--- a/docs/manual/requirements.tex
+++ b/docs/manual/requirements.tex
@@ -38,8 +38,8 @@ need them both loaded. On RedHat systems,  the C++ compiler is part of the
    also runs under GNOME 1.4 but this version is deprecated and  thus no longer
    maintained. 
 \item The wxWidgets Console program is developed and tested with the latest 
-   stable ANSI (not Unicode) version of 
-   \elink{wxWidgets}{http://www.wxwidgets.org/} (2.6.0).  It works fine with the
+   stable ANSI or Unicode version of 
+   \elink{wxWidgets}{http://www.wxwidgets.org/} (2.6.1).  It works fine with the
    Windows and GTK+-2.x version of wxWidgets, and should  also work on other
    platforms supported by wxWidgets. 
 \item The Tray Monitor program is developed for GTK+-2.x. It needs  Gnome less

diff --git a/docs/manual/storedconf.tex b/docs/manual/storedconf.tex
index 93c070b6e4d06504e5265488dbe4663b17872308..4e44c9f3ed70c1f424e444066d7c08900730ae47 100644 (file)
--- a/docs/manual/storedconf.tex
+++ b/docs/manual/storedconf.tex
@@ -809,15 +809,15 @@ Bacula version 1.37 and later.
    \index[sd]{Write Part Command  }
    Command that must be executed to write a part to the device. Before the 
    command is executed, \%a is replaced with the Archive Device, \%m with the 
-   Mount Point, \%n with the current part number (0-based), and \%v with the 
-   current part filename.
+   Mount Point, \%e is replaced with 1 if we are writing 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-writepart} script as follows:  
 
 \footnotesize
 \begin{verbatim}
-  Write Part Command = "/path/dvd-writepart %n %a %v"
+  Write Part Command = "/path/dvd-writepart %e %a %v"
 \end{verbatim}
 \normalsize
 
@@ -831,16 +831,16 @@ Bacula version 1.37 and later.
 \item [Free Space Command = {\it name-string}]
    \index[sd]{Free Space Command  }
    Command that must be executed to check how much free space is left on the 
-   device. Before the command is executed, \%a is replaced with the Archive 
-   Device, \%m with the Mount Point, \%n with the current part number (0-based), 
-   and \%v with the current part filename.
+   device. Before the command is executed,\%a is replaced with the Archive
+   Device, \%m with the Mount Point, \%e is replaced with 1 if we are writing
+   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:  
 
 \footnotesize
 \begin{verbatim}
-  Free Space Command = "/path/dvd-freespace %n %a"
+  Free Space Command = "/path/dvd-freespace %a"
 \end{verbatim}
 \normalsize
 
@@ -1032,8 +1032,8 @@ Device {
 #  MountCommand = "/bin/mount -t iso9660 -o ro %a %m";
 #  UnmountCommand = "/bin/umount %m";
 #  SpoolDirectory = /tmp/backup;
-#  WritePartCommand = "/etc/bacula/dvd-writepart %n %a %v"
-#  FreeSpaceCommand = "/etc/bacula/dvd-freespace %a %n"
+#  WritePartCommand = "/etc/bacula/dvd-writepart %e %a %v"
+#  FreeSpaceCommand = "/etc/bacula/dvd-freespace %a"
 #}
 #
 # A very old Exabyte with no end of media detection