From: Eric Bollengier Date: Thu, 25 Nov 2010 19:47:17 +0000 (+0100) Subject: update new features X-Git-Tag: Release-5.2.1~57^2~3 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=8591f7583d177301ccb5b6654818dedad76f3709;p=bacula%2Fdocs update new features --- diff --git a/docs/manuals/en/main/newfeatures.tex b/docs/manuals/en/main/newfeatures.tex index 7a1c1482..215b94d3 100644 --- a/docs/manuals/en/main/newfeatures.tex +++ b/docs/manuals/en/main/newfeatures.tex @@ -33,10 +33,10 @@ by Bacula Systems. \section{Job Bandwidth Limitation} -A new directive may be added to FileDaemon or Director resources within the -File Daemon configuration to allow users to limit the bandwidth used by a Job -on a Client. It can be set for all Jobs globally or per Directors in the File -Daemon configuration, and per Job in the Director configuration file. +A new directive may be added to FileDaemon or Director to allow users to limit +the bandwidth used by a Job on a Client. It can be set for all Jobs globally, +per Directors in the File Daemon configuration, or per Job in the Director +configuration file. For example: \begin{verbatim} @@ -158,8 +158,8 @@ FileSet { } \end{verbatim} -This project was funded by Bacula Systems and is available with Bacula Enterprise -Edition. +This project was funded by Bacula Systems and is available with Bacula +Enterprise Edition. \section{Changes in Bvfs (Bacula Virtual FileSystem)} @@ -169,6 +169,9 @@ directories. It's still experimental. \texttt{Important}, the Bvfs module is not currently compatible with BaseJobs, Copy and Migration jobs. +\medskip +This project was funded by Bacula Systems. + \subsection*{General notes} \begin{itemize} @@ -192,7 +195,7 @@ Bvfs allows you to query the catalog against any combination of jobs. You can combine all Jobs and all FileSet for a Client in a single session. To get all JobId needed to restore a particular job, you can use the -\texttt{.bvfs_get_jobids} command. +\texttt{.bvfs\_get\_jobids} command. \begin{verbatim} .bvfs_get_jobids jobid=num [all] @@ -213,7 +216,7 @@ this client. \subsection*{Generating Bvfs cache} -The \texttt{.bvfs_update} command computes the directory cache for jobs +The \texttt{.bvfs\_update} command computes the directory cache for jobs specified in argument, or for all jobs if unspecified. \begin{verbatim} @@ -230,7 +233,7 @@ You can run the cache update process in a RunScript after the catalog backup. \subsection*{Get all versions of a specific file} Bvfs allows you to find all versions of a specific file for a given Client with -the \texttt{.bvfs_version} command. To avoid problems with encoding, this function +the \texttt{.bvfs\_version} command. To avoid problems with encoding, this function uses only PathId and FilenameId. The jobid argument is mandatory but unused. \begin{verbatim} @@ -341,7 +344,7 @@ OK \subsection*{Cleanup after restore} To drop the table used by the restore command, you can use the -\texttt{.bvfs_cleanup} command. +\texttt{.bvfs\_cleanup} command. \begin{verbatim} .bvfs_cleanup path=b20001 @@ -395,6 +398,10 @@ Priority: 10 OK to run? (yes/mod/no): \end{verbatim} +\medskip +This project was funded by Bacula Systems and is available with Bacula +Enterprise Edition and Community Edition. + \section{Additions to RunScript variables} You can have access to JobBytes and JobFiles using %b and %f in your runscript command. @@ -403,15 +410,15 @@ command. RunAfterJob = "/bin/echo Job=%j JobBytes=%b JobFiles=%f" \end{verbatim} -\section{Changes in drivetype.exe} - -Now the \texttt{drivetype.exe} program allows you to list all local hard -drives. It can help to build dynamic FileSet on Windows. - -\begin{verbatim} -File = "\\|\"c:/program files/bacula/bin32/drivetype\" -l -a" -\end{verbatim} - +%\section{Changes in drivetype.exe} +% +%Now the \texttt{drivetype.exe} program allows you to list all local hard +%drives. It can help to build dynamic FileSet on Windows. +% +%\begin{verbatim} +%File = "\\|\"c:/program files/bacula/bin32/drivetype\" -l -a" +%\end{verbatim} +% \section{Additions to the Plugin API} The bfuncs structure has been extended to include a number of @@ -442,8 +449,9 @@ typedef struct s_baculaFuncs { bRC (*AddExclude)(bpContext *ctx, const char *file); bRC (*AddInclude)(bpContext *ctx, const char *file); bRC (*AddIncludeOptions)(bpContext *ctx, const char *opts); - bRC (*AddRegexToInclude)(bpContext *ctx, const char *item, int type); - bRC (*AddWildToInclude)(bpContext *ctx, const char *item, int type); + bRC (*AddRegex)(bpContext *ctx, const char *item, int type); + bRC (*AddWild)(bpContext *ctx, const char *item, int type); + bRC (*checkChanges)(bpContext *ctx, struct save_pkt *sp); } bFuncs; \end{verbatim} @@ -531,6 +539,12 @@ typedef struct s_baculaFuncs { \item [F] regex applies only to the filename (directory or path stripped). \item [D] regex applies only to the directory (path) part of the name. \end{description} + +\item [checkChanges] call the \texttt{check\_changes()} function in Bacula code + that can use Accurate code to compare the file information in argument with + the previous file information. The \texttt{delta\_seq} attribute of the + \texttt{save\_pkt} will be updated, and the call will return + \texttt{bRC\_Seen} if the core code wouldn't decide to backup it. \end{description} @@ -559,7 +573,10 @@ typedef enum { bEventVssRestoreLoadComponentMetadata = 15, bEventVssRestoreSetComponentsSelected = 16, bEventRestoreObject = 17, - bEventEndFileSet = 18 + bEventEndFileSet = 18, + bEventPluginCommand = 19, + bEventVssBeforeCloseRestore = 20, + bEventVssPrepareSnapshot = 21 } bEventType; \end{verbatim} @@ -570,9 +587,13 @@ typedef enum { \item [bEventVssBackupAddComponents] +\item [bEventVssPrepareSnapshot] is called before creating VSS snapshots, it + provides a char[27] table where the plugin can add Windows drives that will + be used during the Job. You need to add them without duplicates, and you can + use in \texttt{fd\_common.h} \texttt{add\_drive()} and \texttt{copy\_drives()} + for this purpose. \end{description} - \chapter{Release Version 5.0.3} There are no new features in version 5.0.2. This version simply fixes a