summaryrefslogtreecommitdiffabout
authorSergey Poznyakoff <gray@gnu.org>2020-04-17 11:38:17 (GMT)
committer Sergey Poznyakoff <gray@gnu.org>2020-04-17 11:38:17 (GMT)
commit39cb043bf015b36819a9f431c386592c59480f92 (patch) (side-by-side diff)
tree7ce7660b52aad2ff9e61eb8a62867f454cc53213
parent7a1985a0f05564fd7c381e828ff134836f3e3253 (diff)
downloadwydawca-39cb043bf015b36819a9f431c386592c59480f92.tar.gz
wydawca-39cb043bf015b36819a9f431c386592c59480f92.tar.bz2
Update the docs
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--NEWS42
-rw-r--r--doc/wydawca.texi23
-rw-r--r--src/config.c6
3 files changed, 67 insertions, 4 deletions
diff --git a/NEWS b/NEWS
index 153b579..1f77c3a 100644
--- a/NEWS
+++ b/NEWS
@@ -5,8 +5,50 @@ Please send Wydawca bug reports to <bug-wydawca@gnu.org.ua>.
Version 3.1.95 (git)
+This is a complete rewrite of the wydawca code base. The operating
+model changed from multi-process to multi-thread.
+
+Other important changes:
+
* Configuration file name changed to "wydawca.conf"
+* Initial scanning of spools
+
+Upon startup, wydawca always scans the configured spools. This
+ensures that when started in daemon mode, it will pick up any
+triplets that may have been upload while it was down.
+
+* No unnecessary chdirs.
+
+Wydawca uses POSIX *at() functions instead of changing directories or
+using absolute pathnames. During operation, the daemon stays at the
+"/" as its current working directory. The only exception is changing
+to the temporary working directory when running the distribution
+verification script (which occurs in a sub-process).
+
+As a consequence the number of file descriptors wydawca needs to have
+open is increased. The following relation gives the estimate:
+
+ S + T + D + 2
+
+where S is the number of configured spools, D is the number of
+dictionaries, and T is the maximum number of triplets to handle
+simultaneously.
+
+* Configuration changes
+
+** The wakeup-interval statement removed
+
+** max-connections statement
+
+This new statement configures the maximum number of upload
+notification connections. Default is 16.
+
+** idle-timeout statement
+
+This new statement configures the maximum idle timeout of an
+upload notification connection. Default is 10 seconds.
+
Version 3.1, 2020-03-13
diff --git a/doc/wydawca.texi b/doc/wydawca.texi
index 430e300..4f40cb0 100644
--- a/doc/wydawca.texi
+++ b/doc/wydawca.texi
@@ -1129,6 +1129,19 @@ Declare a special service name, which will be treated as a request to
process all spools.
@end deffn
+@deffn {Config} max-connections n
+Limits the number of upload notification connections allowed to be
+open simultaneously. The default value is 16 connections.
+@end deffn
+
+@deffn {Config} idle-timeout interval
+Sets the idle timeout for upload notification connections. If a
+connection stays idle for more than the given interval, it will be
+closed forcibly. Default idle timout is 10 seconds.
+
+@xref{time interval specification}, for the syntax of @var{interval}.
+@end deffn
+
@deffn {Config} pidfile file
Store master process @acronym{PID} in @var{file}. Default pidfile
location is @file{@var{localstatedir}/run/wydawca.pid}.
@@ -3383,6 +3396,14 @@ locking @{
# @xref{daemon, listen}.
listen @var{socket:@i{sock-addr}};
+# @r{Maximum number of simultaneous upload notification connections.}
+# @xref{daemon, max-connections}.
+max-connections @var{n};
+
+# @r{Idle timeout for an upload notification connection.}
+# @xref{daemon, idle-timeout}.
+idle-timeout @var{time:@i{interval}};
+
# @r{Configure TCP wrappers.}
# @xref{tcp-wrapper}.
tcp-wrapper @{
@@ -3484,7 +3505,7 @@ notify-event @{
# @r{Define file sweep time.}
# @xref{general, file-sweep-time}.
-file-sweep-time @var{time:@i{int9erval}};
+file-sweep-time @var{time:@i{interval}};
# @r{Set tar invocation command line.}
# @xref{archivation, tar-program}.
diff --git a/src/config.c b/src/config.c
index a7d4312..9c381ea 100644
--- a/src/config.c
+++ b/src/config.c
@@ -1487,13 +1487,13 @@ static struct grecs_keyword wydawca_kw[] = {
cb_locking, NULL, locking_kw },
{ "listen", N_("socket"),
- N_("Listen on this address"),
+ N_("Listen on this address for upload notification connections."),
grecs_type_sockaddr, GRECS_DFLT, &listen_sockaddr, },
{ "max-connections", NULL,
- N_("maximum allowed number of simultaneous connections"),
+ N_("maximum allowed number of simultaneous connections."),
grecs_type_size, GRECS_DFLT, &max_connections },
{ "idle-timeout", N_("interval"),
- N_("Idle timeout for a TXPMUX connection"),
+ N_("Idle timeout for upload notification connection."),
grecs_type_string, GRECS_CONST, &idle_timeout, 0, cb_interval },
#ifdef WITH_LIBWRAP

Return to:

Send suggestions and report system problems to the System administrator.