bareos.sty

%% bareos.sty
%% Provides macros and other stuff for the bareos manual
%%
%% Original Creation -- K. Cunningham 2005-01-09
%%
%% New Commands Currently implemented:
%%
%% \elink{target}{text}
%%    Inserts the text indicated (highlighted) and provides
%%    an external hyperlink to the target.
%%
%% \ilink{target}{text}
%%    Inserts the text indicated (highlighted) and provides
%%    an internal hyperlink to the target. Target must be a
%%    \label somewhere in the same document.
%%
%% \idir
%%    Inserts the path to the images
%%
\ProvidesPackage{bareos}[2012/11/16]
%%
%%
%% define images directory
\def\idir{../../images/conv/}  %% images directory

%
% Bareos paths and filenames
%
\newcommand{\fileStoragePath}{\path|/var/lib/bareos/storage/|}
\newcommand{\scriptPathUnix}{\path|/usr/lib/bareos/scripts/|}
\newcommand{\configPathUnix}{\path|/etc/bareos/|}
\newcommand{\configFileDirUnix}{\path|/etc/bareos/bareos-dir.conf|}
\newcommand{\logfileUnix}{\path|/var/log/bareos/bareos.log|}

\newcommand{\yesno}{yes{\textbar}no}
%
% data type definitions. 
% all data types should be defined here.
% use them in xdirective.
\csdef{dtAcl}{\ilink{acl}{DataTypeAcl}}
\csdef{dtAddress}{\ilink{net-address}{DataTypeNetAddress}}
\csdef{dtAddresses}{\ilink{net-addresses}{DataTypeNetAddresses}}
\csdef{dtAutopassword}{\ilink{password}{DataTypePassword}}
\csdef{dtBoolean}{\ilink{\yesno}{DataTypeYesNo}}
\csdef{dtDirectory}{\ilink{directory}{DataTypeDirectory}}
\csdef{dtName}{\ilink{name}{DataTypeName}}
\csdef{dtNetAddress}{\ilink{net-address}{DataTypeNetAddress}}
\csdef{dtNetAddresses}{\ilink{net-addresses}{DataTypeNetAddresses}}
\csdef{dtNetPort}{\ilink{net-port}{DataTypeNetPort}}
\csdef{dtMessages}{[ address = ] \ilink{message-type}{MessageTypes} [ , \ilink{message-type}{MessageTypes} ]* }
\csdef{dtPassword}{\ilink{password}{DataTypePassword}}
\csdef{dtPath}{\ilink{path}{DataTypePath}}
% use csdef instead of newcommand, because command contains numbers
\csdef{dtPint32}{\dtUInt}
\csdef{dtRes}{\ilink{resource-name}{DataTypeRes}}
\csdef{dtPort}{\dtNetPort}
\csdef{dtScheduleRunCommand}{{job-overrides{\gt} {\lt}date-time-specification}}
\csdef{dtSize}{\ilink{size}{DataTypeSize}}
\csdef{dtSpeed}{\ilink{speed}{DataTypeSpeed}}
\csdef{dtString}{\ilink{string}{DataTypeString}}
\csdef{dtStringList}{\ilink{string-list}{DataTypeStringList}}
\csdef{dtTime}{\ilink{time}{DataTypeTime}}
\csdef{dtUInt}{\ilink{positive-integer}{DataTypePositiveInteger}}
\csdef{dtYesNo}{\ilink{\yesno}{DataTypeYesNo}}

\newcommand{\dt}[1]{%
    \ifcsdef{dt#1}{\csuse{dt#1}}{\path|#1|}%
}

%
% references
%

% 1: text, 2: URL
\newcommand*{\elink}[2]{%
    %\htmladdnormallink{#1}{#2}%
    \href{#2}{#1}%
}
% or use \url{URL}

% 1: text, 2. label
\newcommand*{\ilink}[2]{%
  %\htmlref{#1}{#2}%
    \hyperref[#2]{#1}%
}
% or use \nameref{label} or \autoref{label}

% for links directly to a text (not just only to the section) use
% \hyppertarget{label}{text}
% and
% \hyperlink{label}{text}


%
% special characters
%
\newcommand{\at}{\makeatletter @\makeatother}
\newcommand{\lt}{\textless}
\newcommand{\gt}{\textgreater}
\newcommand{\pipe}{\textbar\ }
% these characters must be quoted in Bareos config files: &<>()@^|
\newcommand{\configCharsToQuote}{\parameter{&<>()@^}\textbar\ }

%
% specific types of text
%
\newcommand{\commandPrompt}{root{\at}linux:\~{}\# }
\newcommand{\command}[1]{\path|#1|}
\newcommand{\bcommand}[1]{\path|#1|}
\newcommand{\file}[1]{\path|#1|}
\newcommand{\directory}[1]{\path|#1|}
\newcommand{\package}[1]{\path|#1|}
\newcommand{\name}[1]{\textbf{#1}}
\newcommand{\user}[1]{\path|#1|}
\newcommand{\group}[1]{\path|#1|}
\newcommand{\parameter}[1]{\path|#1|}
\newcommand{\variable}[1]{\path|#1|}
% to also link to a directive, use \linkResourceDirective}{Dir|Sd|Fd}{Resource}{Directive Name}
\newcommand{\configdirective}[1]{\textbf{#1}}
\newcommand{\configline}[1]{\path|#1|}
\newcommand{\host}[1]{\path|#1|}
\newcommand{\email}[1]{\url{#1}}
\newcommand{\bnfvar}[1]{\lt#1\gt}

%%
\newcommand{\debug}[1]{\marginpar{#1}}
%%
%\newcommand{\TODO}[1]{\textit{#1}\marginpar{TODO: #1}}
\newcommand{\TODO}[1]{\textit{TODO: #1}}
%\newcommand{\TODO}[1]{}
\newcommand{\hide}[1]{}
%
\newcommand{\warning}[1]{Please note! \textit{#1}}

% 1: version, 2: description
\newcommand{\releasenote}[2]{
    \subsection*{bareos-#1}
    \index[general]{#1!Release Notes}%
    #2
}

\newcommand{\sinceVersion}[3]{%
% 1: daemon (dir|sd|fd),
% 2: item,
% 3: version
\edef\pv{#3}%
\ifcsvoid{pv}{}{%
Version $>=$ #3%
\index[#1]{#2}%
% expand variables
\edef\temp{\noexpand\index[general]{#3!#2}}%
\temp%
}
}

\newcommand{\betaSince}[3]{\index[#1]{#2}Included as beta since version #3. Don't use in productive environment!}
\newcommand{\deprecatedSince}[3]{This option is deprecated since version #3}
\newcommand{\removedSince}[3]{This option is removed since version #3}

% deprecated. use xdirective instead.
\newcommand{\directive}[6]{
% 1: config file (dir | sd | fd)
% 2: directive name
% 3: directive type/value
% 4: "required" | ""
% 5: default value
% 6: since version
\item [#2 = {\textless}#3{\textgreater}]
    \hfill
  \ifthenelse{\isempty{#5}}{}{(default: #5)}
  \ifthenelse{\isempty{#4}}{}{(#4)}
  \ifthenelse{\isempty{#6}}{}{\sinceVersion{#1}{#2}{#6}}
  \hfill \\
  \index[#1]{#2}
  \index[#1]{Directive!#2}
}

\newcommand{\xdirective}[8]{
% 1: config file (Dir | Sd | Fd)
% 2: Resource
% 3: directive name
% 4: directive data type (\dtXXX) or value
% 5: "required" | ""
% 6: default value
% 7: "deprecated" | since version
% 8: description
%
% translate daemon name to lowercase.
% Unfortunally, the result of
% \MakeLowercase{#1} or \makefirstuc{#1}
% can be used for \index
\ifthenelse{\equal{#1}{Dir}}{
    \def\daemon{dir}
}{ 
  \ifthenelse{\equal{#1}{Sd}}{
    \def\daemon{sd}
  }{ 
    \ifthenelse{\equal{#1}{Fd}}{
        \def\daemon{fd}
    }{
        % hopefully, no translatation needed. Take original parameter
        \def\daemon{#1}
    }
  }
}
%
\item [\hypertarget{directive#1#2#3}{#3} = {\textless}#4{\textgreater}]%
    \hfill%
  \ifthenelse{\isempty{#6}}{}{(default: #6)}%
  \ifthenelse{\isempty{#5}}{}{(#5)}%
  \hfill \\%
  \index[\daemon]{#3|textbf}%
  \index[\daemon]{Directive!#3|textbf}%
  \ifthenelse{\equal{#7}{deprecated}}{%
\warning{This directive is deprecated.\\}
  }{}%
#8\ \\%
  \ifthenelse{\equal{#7}{deprecated}}{}{%
    \ifthenelse{\equal{#7}{}}{}{%
      \sinceVersion{\daemon}{#3}{#7}%
    }%
  }%
}
% usage:
% \xdirective{Dir|Sd|Fd}{Resource}{Name}{\dtXXX}{required}{default}{version}{%
% }
% \xdirective{}{}{}{}{required}{}{}{}


\newcommand{\defDirective}[6]{%
% defDirective: 
%   provide additional information to a directive.
%   These information will not displayed right away,
%   but used by \resourceDirective
%   which will be used at autogenerated/*-resource-*-description.tex
%
% 1: daemon (Dir | Sd | Fd)
% 2: Resource
% 3: DirectiveName
% 4: "" | parameter (postgresql | mysql | ...)
% 5: "" | since version
% 6: description
%       can't contain verbatim/lstlisting parts. 
%       Therefore use \bconfiginput{filename} to include config examples.
\def\pp{#4}
\def\pv{#5}
\def\pd{#6}
\ifcsvoid{pp}{}{%
    \csdef{directiveParameter#1#2#3}{#4}%
}%
\ifcsvoid{pv}{}{%
    \csdef{directiveSinceVersion#1#2#3}{#5}%
}%
\ifcsvoid{pd}{}{%
    \csdef{directiveDescription#1#2#3}{#6}%
}%
%
\ifcsvoid{resourceDirectiveDefined#1#2#3}{%
\wlog{Warning: defDirective{#1}{#2}{#3} has no matching resourceDirective and will be ignored}
}{}%
}

\newcommand{\resourceDirective}[8]{%
% 1: config file (Dir | Sd | Fd)
% 2: Resource
% 3: directive name
% 4: directive data type (\dtXXX) or value
% 5: "required" | ""
% 6: default value
% 7: "deprecated" | since version
% 8: description
\ifcsdef{directiveParameter#1#2#3}{%
    \csletcs{resourceDirectiveParameter}{directiveParameter#1#2#3}%
}{%
    \csdef{resourceDirectiveParameter}{#4}%
}%
\ifcsdef{directiveSinceVersion#1#2#3}{%
    \csletcs{resourceDirectiveVersion}{directiveSinceVersion#1#2#3}%
}{%
    \csedef{resourceDirectiveVersion}{#7}%
}%
\xdirective{#1}{#2}{#3}{\resourceDirectiveParameter}{#5}{#6}{\resourceDirectiveVersion}{%
\ifthenelse{\isempty{#8}}{}{%
#8

}%
\ifcsdef{directiveDescription#1#2#3}{\csuse{directiveDescription#1#2#3}}{}%
}%
}

\newcommand{\linkResourceDirective}[3]{%
% 1: config file (Dir | Sd | Fd)
% 2: Resource
% 3: Directive Name
%
\ifthenelse{\equal{#1}{Dir}}{%
    \def\daemon{dir}%
}{%
  \ifthenelse{\equal{#1}{Sd}}{%
    \def\daemon{sd}%
  }{%
    \ifthenelse{\equal{#1}{Fd}}{%
        \def\daemon{fd}%
    }{%
        % hopefully, no translatation needed. Take original parameter
        \def\daemon{#1}%
    }%
  }%
}%
\index[\daemon]{Directive!#3}%
\hyperlink{directive#1#2#3}{#3}%
}



\lstnewenvironment{bconsole}[1]{
    % #1 caption
    \renewcommand*{\lstlistingname}{bconsole}
    \definecolor{colorBconsole}{gray}{0.9}
    \lstset{
        %label=bconsole:#1,
        caption=#1,
        %basicstyle=\ttfamily,
        basicstyle=\small,
        stringstyle=\ttfamily,
        keepspaces=true,
        columns=fixed,
        backgroundcolor=\color{colorBconsole},
        frame=single,
        framerule=0pt,
        captionpos=b,
        %moredelim=[l][\bf]{* },
        %moredelim=[l][\bf]{Select\ item: },
        %moredelim=[l][\bf]{Select\ Client },
        moredelim=[is][\bf]{<input>}{</input>},
        moredelim=[is][\underline]{<strong>}{</strong>},
    }
}{}


\lstnewenvironment{bmessage}[1]{%
    % #1 caption
    \renewcommand*{\lstlistingname}{Messages} 
    \footnotesize
    \definecolor{colorConfig}{gray}{0.9}
    \lstset{
        backgroundcolor=\color{colorConfig},
        frame=single,
        framerule=0pt,
        basicstyle=\ttfamily,
        keepspaces=true,
        columns=fullflexible,
        %label=config:#1,
        caption=#1,
        captionpos=b,
        moredelim=[is][\it]{<input>}{</input>},
        moredelim=[is][\underline]{<strong>}{</strong>},
    }
}{}


\definecolor{colorConfig}{gray}{0.9}

\lstnewenvironment{bconfig}[1]{%
    % #1 caption
    \renewcommand*{\lstlistingname}{Configuration} 
    \footnotesize
    \lstset{
        backgroundcolor=\color{colorConfig},
        frame=single,
        framerule=0pt,
        basicstyle=\ttfamily,
        keepspaces=true,
        columns=fullflexible,
        %label=config:#1,
        caption=#1,
        captionpos=b,
        moredelim=[is][\it]{<input>}{</input>},
        moredelim=[is][\underline]{<strong>}{</strong>},
    }
}{}

\newcommand{\bconfigInput}[1]{
    {
        \footnotesize
%     \lstinputlisting[backgroundcolor=\color{colorConfig},frame=single,framerule=0pt,basicstyle=\ttfamily,keepspaces=true,columns=fullflexible,moredelim=[is][\it]{<input>}{</input>},moredelim=[is][\underline]{<strong>}{</strong>}]{#1}
        \lstinputlisting[
                backgroundcolor=\color{colorConfig},
                frame=single,framerule=0pt,
                basicstyle=\ttfamily,
                keepspaces=true,
                columns=fullflexible
            ]{#1}
    }
}

\lstnewenvironment{config}[1]{%
    % #1 caption
    \renewcommand*{\lstlistingname}{Configuration}
    \footnotesize
    \definecolor{colorConfig}{gray}{0.9}
    \lstset{
        backgroundcolor=\color{colorConfig},
        frame=single,
        framerule=0pt,
        basicstyle=\ttfamily,
        keepspaces=true,
        columns=fullflexible,
        %label=config:#1,
        caption=#1,
        captionpos=b,
        moredelim=[is][\it]{<input>}{</input>},
        moredelim=[is][\underline]{<strong>}{</strong>},
    }
}{}


\lstnewenvironment{commands}[1]{%
    % #1 caption
    \renewcommand*{\lstlistingname}{Commands}
    \footnotesize
    \definecolor{colorConfig}{gray}{0.9}
    \lstset{
        backgroundcolor=\color{colorConfig},
        frame=single,
        framerule=0pt,
        basicstyle=\ttfamily,
        keepspaces=true,
        columns=fullflexible,
        caption=#1,
        captionpos=b,
        % command only work for single commands without parameter.
        % as workaround, split a command and its parameter as in following example:
        % <command>su</command><input> - bareos</input>
        moredelim=[is][\commandPrompt\bf]{<command>}{</command>},
        moredelim=[is][\bf]{<parameter>}{</parameter>},
        moredelim=[is][\bf]{<input>}{</input>},
        moredelim=[is][\underline]{<strong>}{</strong>},
    }
}{}


\newfloat{floatCommandOut}{h}{lop}
\floatname{floatCommandOut}{Command}

\newenvironment{commandOut}[3]{%
    % #1 caption
    % #2 prompt
    % #3 command
    \footnotesize
    \def\commandOut1{#1}
    \ifthenelse{\isempty{#2}}{
        \def\commandOutPrompt{\commandPrompt}
    }{
        \def\commandOutPrompt{#2}
    }

    % \definecolor{shadecolor}{gray}{0.95}
    % TODO: does not work with htlatex
    % \snugshade
    \verbatim
\commandOutPrompt{}#3
}
{
    \endverbatim
    % \endsnugshade
    \ifthenelse{\isempty{\commandOut1}}{
    }{
        \captionof{floatCommandOut}{\commandOut1}
    }
}


\endinput