From 86338fb43571e2c752f76abc45e223bd54c68de1 Mon Sep 17 00:00:00 2001
From: Eric Bollengier <eric@eb.homelinux.org>
Date: Wed, 12 Aug 2009 20:47:34 +0000
Subject: [PATCH] ebl  update with bvfs

---
 docs/manuals/en/concepts/newfeatures.tex | 84 ++++++++++++++++++++++--
 1 file changed, 80 insertions(+), 4 deletions(-)

diff --git a/docs/manuals/en/concepts/newfeatures.tex b/docs/manuals/en/concepts/newfeatures.tex
index 86bde6fd..e099ec09 100644
--- a/docs/manuals/en/concepts/newfeatures.tex
+++ b/docs/manuals/en/concepts/newfeatures.tex
@@ -11,6 +11,17 @@ versions to be released as Bacula version 3.0.3 sometime in 2009.
 \section{Restore from multiple Storage Daemon}
 \index[general]{Restore}
 
+Previously, you were able to restore from multiple devices in a single Storage
+Daemon. Now, Bacula is able to restore from multiple Storage Daemon. For
+example, if your full backup runs on a Storage Daemon with an autochanger, and
+your incremental jobs use an other Storage Daemon with lots of disks, Bacula
+will switch automatically from a Storage Daemon to an other in the same Restore
+job.
+
+You need to upgrade your File Daemon to use this feature.
+
+This project was funded by Bacula Systems with the help of Equiinet.
+
 \section{File deduplication using Base jobs}
 
 A base job is sort of like a Full save except that you will want the FileSet to
@@ -48,12 +59,76 @@ Job {
 }
 \end{verbatim}
 
-In this example, the job \texttt{BackupZog4} will use the most recent version of all
-files contained in \texttt{BackupZog4} and \texttt{BackupLinux} jobs. Base jobs should
-have run with \texttt{level=Base} to be used.
+In this example, the job \texttt{BackupZog4} will use the most recent version
+of all files contained in \texttt{BackupZog4} and \texttt{BackupLinux}
+jobs. Base jobs should have run with \texttt{level=Base} to be used.
 
 This project was funded by Bacula Systems.
 
+\section{Bvfs API}
+\label{sec:bvfs}
+
+To help developers in restore GUI interfaces, we have added new \textsl{dot
+  commands} that permit to browse the catalog in a very simple way.
+
+\begin{itemize}
+\item \texttt{.update [jobid=x,y,z]} This command is required to update the
+  Bvfs cache in the catalog. You need to run it before any access to the Bvfs
+  layer.
+\item \texttt{.lsdirs jobid=x,y,z path=/path | pathid=101} This command will
+  list all directories in the specified \texttt{path} or \texttt{pathid}. Using
+  \texttt{pathid} avoids problems with caracters encoding.
+\item \texttt{.lsfiles jobid=x,y,z path=/path | pathid=101} This command will
+  list all files in the specified \texttt{path} or \texttt{pathid}. Using
+  \texttt{pathid} avoids problems with caracters encoding.
+\end{itemize}
+
+You can use \texttt{limit=xxx} and \texttt{offset=yyy} to limit the amount of
+data that will be displayed.
+
+\begin{verbatim}
+* .update jobid=1,2
+* .update
+* .lsdir path=/ jobid=1,2
+\end{verbatim}
+
+\section{Bat new features}
+
+\subsection{Media information view}
+
+When double-clicking on a volume (on the Media list, in the Autochanger content
+or in the Job information panel), you can access to a detailed overview of your
+volume. (cf \ref{fig:mediainfo}.)
+\begin{figure}[htbp]
+  \centering
+  \includegraphics[width=13cm]{\idir bat11.eps}  
+  \caption{Media information}
+  \label{fig:mediainfo}
+\end{figure}
+
+\subsection{Job information view}
+
+When double-clicking on a Job record (on the Job run list or in the Media
+information panel), you can access to a detailed overview of your Job. (cf
+\ref{fig:jobinfo}.)
+\begin{figure}[htbp]
+  \centering
+  \includegraphics[width=13cm]{\idir bat12.eps}  
+  \caption{Job information}
+  \label{fig:jobinfo}
+\end{figure}
+
+\subsection{Autochanger content view}
+
+When double-clicking on a Storage record (on the Storage list panel), you can
+access to a detailed overview of your Autochanger. (cf \ref{fig:jobinfo}.)
+\begin{figure}[htbp]
+  \centering
+  \includegraphics[width=13cm]{\idir bat13.eps}  
+  \caption{Autochanger content}
+  \label{fig:achcontent}
+\end{figure}
+
 \chapter{New Features in 3.0.2}
 
 This chapter presents the new features added to the development 3.0.2
@@ -77,7 +152,8 @@ Assume we start with the following jobs:
 +-------+--------------+---------------------+-------+----------+------------+
 \end{verbatim}
 
-Below is an example of selecting this new feature (which is number 12 in the menu).
+Below is an example of selecting this new feature (which is number 12 in the
+menu).
 
 \begin{verbatim}
 * restore
-- 
2.39.5