From: Eric Bollengier <eric@baculasystems.com>
Date: Mon, 30 Dec 2013 14:01:01 +0000 (+0100)
Subject: Add documentation on new .api version
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=84c2e8e71f3f0a3c2c155e44a41fa3f2bd2c6f7c;p=bacula%2Fdocs

Add documentation on new .api version
---

diff --git a/docs/manuals/en/main/newbsfeatures.tex b/docs/manuals/en/main/newbsfeatures.tex
index cbd7866f..3b2ecdad 100644
--- a/docs/manuals/en/main/newbsfeatures.tex
+++ b/docs/manuals/en/main/newbsfeatures.tex
@@ -7,6 +7,56 @@ In addition to the features in this chapter, the Enterprise version
 includes all the Community features described in the Community new Features
 chapter.
 
+\section{Bacula Enterprise 6.7.0}
+
+\subsection{Data Encryption Cipher Configuration}
+Bacula Enterprise version 6.7.0 and later now allows to configure the data
+encryption cipher and the digest algorithm. The cipher was forced to AES 128,
+and it is now possible to choose between the following ciphers:
+
+\begin{itemize}
+\item AES128 (default)
+\item AES192
+\item AES256
+\item blowfish
+\end{itemize}
+
+The digest algorithm was set to SHA1 or SHA256 depending on the local OpenSSL
+options. We advise you to not modify the PkiDigest default setting. Please,
+refer to OpenSSL documentation to know about pro and cons on these options.
+
+\begin{lstlisting}
+  FileDaemon {
+    ...
+    PkiCipher = AES256
+  }
+\end{lstlisting}
+
+\subsection{Minor Enhancements}
+
+\subsubsection*{.api version 2}
+
+In Bacula Enterprise version 6.7.0 and later, we introduced a new .api version
+to help external tools to parse various Bacula outputs.
+
+The \texttt{api\_opts} option can use the following arguments:
+\begin{itemize}
+\item [C] Clear current options
+\item [tn] Use a specific time format (1 ISO format, 2 Unix Timestamp, 3 default Bacula time format)
+\item [sn] Use a specific separator between items (new line by default).
+\item [Sn] Use a specific separator between objects (new line by default).
+\item [o] Convert all keywords to lowercase and convert all non \textsl{isalpha} characters to \_
+\end{itemize}
+
+\begin{lstlisting}
+  .api 2 api_opts=t1s43S35
+  .status dir running
+==================================
+jobid=10
+job=AJob
+...
+\end{lstlisting}
+
 \section{Bacula Enterprise 6.6.0}
 \subsection{Comm Line Compression}
 Bacula Enterprise version 6.6.0 and later now includes communication