diff options
author | Sergey Poznyakoff <gray@gnu.org> | 2019-07-22 15:52:11 +0300 |
---|---|---|
committer | Sergey Poznyakoff <gray@gnu.org> | 2019-07-22 15:53:41 +0300 |
commit | f8c247bb21e2e93b95f778bf43a7de02a7d1b000 (patch) | |
tree | b8a438b550f3db7998fb8c3d46b566d2e8b228bb /doc/wydawca.texi | |
parent | b369ed6ad26c07d3aec65a1bf0910c0d828c400f (diff) | |
download | wydawca-f8c247bb21e2e93b95f778bf43a7de02a7d1b000.tar.gz wydawca-f8c247bb21e2e93b95f778bf43a7de02a7d1b000.tar.bz2 |
Document directory setup statements.
See commits f338532e, dd9d9c12, and af538cc2.
Diffstat (limited to 'doc/wydawca.texi')
-rw-r--r-- | doc/wydawca.texi | 191 |
1 files changed, 187 insertions, 4 deletions
diff --git a/doc/wydawca.texi b/doc/wydawca.texi index 1f76e71..6f769d1 100644 --- a/doc/wydawca.texi +++ b/doc/wydawca.texi @@ -105,2 +105,3 @@ How to Configure @command{wydawca}. * dictionaries:: +* directory setup:: * archivation:: @@ -129,3 +130,10 @@ SQL Dictionary -Mail Notification +Notification Mechanism + +* modules:: +* event notification:: +* mod_mailutils:: Mail Notification +* mod_logstat:: Notification to syslog + +@command{mod_mailutils}-- Mail Notification @@ -133,4 +141,5 @@ Mail Notification * templates:: -* statreports:: -* event notification:: +* statreports:: +* mail-config:: @code{module-config} for @command{mod_mailutils} +* mod_mailutils example:: Example of @command{mod_mailutils} configuration @@ -525,2 +534,3 @@ directives any time by running @command{wydawca --config-help}. * dictionaries:: +* directory setup:: * archivation:: @@ -1718,2 +1728,50 @@ implemented. +@node directory setup +@section Directory Setup + +@command{Wydawca} operates on three kinds of directories: spool source +directories (@pxref{spool, source}), destination directories +(@pxref{spool, destination}) and archive directories +(@pxref{archivation}). By default, @command{wydawca} assumes that all +directories specified in its configuration file already exist and have +proper ownership and modes. It will abort if it is not so. + +You can configure @command{wydawca} to create these directories as +needed, and to set up their ownership and modes automatically. + +@deffn {Config} create-directories bool +If set to @samp{yes}, this statement instructs @command{wydawca} to +create any missing directories. +@end deffn + +@deffn {Config} directory-mode mode +Specifies the mode for created directories (in octal). If the +directory already exists, its mode will be checked and if necessary +changed to @var{mode}. + +This statement is overridden by per-directory statements: +@code{source-mode} and @code{destination-mode} statements in +@code{spool} block (@pxref{spool}) and @code{directory-mode} statement +in @code{archive} block (@pxref{archivation}). +@end deffn + +@deffn {Config} directory-owner uid gid +Configures owner user and group IDs for source, destination and +archive directories. + +The @var{uid} argument is either a numeric UID prefixed with a plus +sign, or a symbolic user name, which will be converted to the numeric +UID using the system user database. If a number without the @samp{+} +prefix is supplied, it will first be looked in the password database +as the user name, and, if no such user is found, it will be used as +the numeric UID. + +The same holds for the @var{gid} argument. + +This statement is overridden by per-directory statements: +@code{source-owner} and @code{destination-owner} statements in +@code{spool} block (@pxref{spool}) and @code{directory-owner} statement +in @code{archive} block (@pxref{archivation}). +@end deffn + @node archivation @@ -1741,4 +1799,13 @@ where it affects only the given spool. archive @var{type} @{ + # Name of archive file or directory name @var{file-or-dir}; + + # Define backup type backup @var{type}; + + # mode for the archive directory + directory-mode @var{mode}; + + # owner user and group for the archive directory + directory-owner @var{uid} @var{gid}; @} @@ -1860,2 +1927,23 @@ Always make simple backups. +@deffn {Config: archive} directory-mode mode +Sets directory mode for creating the directory (octal). If the +directory already exists, its mode will be checked and if necessary +changed to @var{mode}. + +This statement overrides the global @code{directory-mode} statement +(@pxref{directory setup}). +@end deffn + +@deffn {Config} directory-owner uid gid +Configures owner user and group IDs for created archive directories. +If the archive directory already exists, its ownership will be checked +and if necessary reverted to @var{uid}:@var{gid}. + +@xref{directory setup, directory-owner}, for a discussion of the +syntax for @var{uid} and @var{gid}. + +This statement overrides the global @code{directory-mode} statement +(@pxref{directory setup}). +@end deffn + @cindex implicit signature archivation @@ -1901,3 +1989,7 @@ spool @var{tag} @{ source @var{dir}; + source-mode @var{mode}; + source-owner @var{uid} @var{gid}; destination @var{dir}; + destination-mode @var{mode}; + destination-owner @var{uid} @var{gid}; file-sweep-time @var{interval}; @@ -1935,2 +2027,23 @@ Specifies the location of the source directory. +@deffn {Config: archive} source-mode mode +Sets directory mode for creating the source directory (octal). If the +directory already exists, its mode will be checked and if necessary +changed to @var{mode}. + +This statement overrides the global @code{directory-mode} statement +(@pxref{directory setup}). +@end deffn + +@deffn {Config} source-owner uid gid +Configures owner user and group IDs for the source directory. +If the directory already exists, its ownership will be checked +and if necessary reverted to @var{uid}:@var{gid}. + +@xref{directory setup, directory-owner}, for a discussion of the +syntax for @var{uid} and @var{gid}. + +This statement overrides the global @code{directory-mode} statement +(@pxref{directory setup}). +@end deffn + @deffn {Config: spool} destination dir @@ -1956,2 +2069,26 @@ are useful mainly for diagnostic purposes. +The following two statements apply only if the destination is a local +directory (@samp{file://} or @samp{dir://} URL scheme): + +@deffn {Config: archive} destination-mode mode +Sets directory mode for creating the destination directory (octal). +If the directory already exists, its mode will be checked and if +necessary changed to @var{mode}. + +This statement overrides the global @code{directory-mode} statement +(@pxref{directory setup}). +@end deffn + +@deffn {Config} destination-owner uid gid +Configures owner user and group IDs for the destination directory. +If the directory already exists, its ownership will be checked +and if necessary reverted to @var{uid}:@var{gid}. + +@xref{directory setup, directory-owner}, for a discussion of the +syntax for @var{uid} and @var{gid}. + +This statement overrides the global @code{directory-mode} statement +(@pxref{directory setup}). +@end deffn + The following statements, if present, override the corresponding global @@ -2128,3 +2265,3 @@ EOT; @cindex statistics -At the end of the run, @command{wydawca} prints a detailed +At the end of the run, @command{wydawca} can print a detailed statistics of its execution on the diagnostic channel @samp{info}. @@ -2216,2 +2353,6 @@ A symlink is removed. +There are two ways to enable the statistics logging. The +@dfn{built-in} statistics output is enabled using the +@code{statistics} keyword. + @deffn {Config} statistics list @@ -2255,2 +2396,5 @@ statistics (all, errors, warnings); +More elaborate output can be produced using the @code{mod_logstat} +loadable module. @xref{mod_logstat}, for a detailed discussion. + @node notification @@ -3384,2 +3528,14 @@ define-message @var{ident:@i{string}} @var{text:@i{string}}; +# @r{Create missing directories.} +# @xref{directory setup}. +create-directories @var{arg:@i{boolean}}; + +# @r{Mode for created directories.} +# @xref{directory setup}. +directory-mode @var{mode}:@i{octal}; + +# @r{Owner user and group for created directory.} +# @xref{directory setup}. +directory-owner @var{uid:@i{string}} @var{gid:@i{string}}; + # @r{Set up archivation.} @@ -3393,2 +3549,9 @@ archive @var{type:@i{string}} @{ backup @var{type:@i{string}}; + + # @r{Mode for the archive directory.} + # @xref{archivation, directory-mode}. + directory-mode @var{mode:@i{octal}}; + + # @r{Owner user and group for the archive directory.} + directory-owner @var{uid:@i{string}} @var{gid:@i{string}}; @} @@ -3420,2 +3583,12 @@ spool @var{tag:@i{string}} @{ + # @r{Mode for the source directory.} + # @xref{spool, source-mode}. + # @xref{directory setup}. + source-mode @var{mode:@i{octal}}; + + # @r{Owner user and group for the source directory.} + # @xref{spool, source-owner}. + # @xref{directory setup}. + source-owner @var{uid:@i{string}} @var{gid:@i{string}}; + # @r{Destination directory.} @@ -3423,2 +3596,12 @@ spool @var{tag:@i{string}} @{ + # @r{Mode for the destination directory.} + # @xref{spool, destination-mode}. + # @xref{directory setup}. + destination-mode @var{mode:@i{octal}}; + + # @r{Owner user and group for the destination directory.} + # @xref{spool, destination-owner}. + # @xref{directory setup}. + destination-owner @var{uid:@i{string}} @var{gid:@i{string}}; + # @r{Define file sweep time.} |