aboutsummaryrefslogtreecommitdiff
path: root/doc/wydawca.texi
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org>2019-07-22 15:52:11 +0300
committerSergey Poznyakoff <gray@gnu.org>2019-07-22 15:53:41 +0300
commitf8c247bb21e2e93b95f778bf43a7de02a7d1b000 (patch)
treeb8a438b550f3db7998fb8c3d46b566d2e8b228bb /doc/wydawca.texi
parentb369ed6ad26c07d3aec65a1bf0910c0d828c400f (diff)
downloadwydawca-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.texi191
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.}

Return to:

Send suggestions and report system problems to the System administrator.