Version 1.2v1.2

24 files changed, 83 insertions, 29 deletions

diff --git a/NEWS b/NEWS
index eacecaf..98185f0 100644
--- a/NEWS
+++ b/NEWS
@@ -1,8 +1,29 @@
-tallyman -- history of user-visible changes. 2019-08-14
+tallyman -- history of user-visible changes. 2020-10-10
 See the end of file for copying conditions.
 
 Please send tallyman bug reports to <gray+tallyman@gnu.org.ua>
 
+Version 1.2, 2020-10-10
+
+* Remove expired services from the table.
+
+A service is removed from the internal tables once the
+`instance-state-ttl' timeout expires.  That means that the
+`instanceState' variable will never have the value of
+`expired(2)'.
+
+* Hostproc interface
+
+Hostproc is an SNMP agent that provides detailed information about
+processes running on a host.  The agent features extensive aggregation
+capabilities that allow the system administrator to obtain various
+types of metric for a group of processes.  Stevedore is able to
+communicate with hostproc and to define process groups for each
+configured service.  That feature allows you to monitor memory and
+CPU usage by each docker service.
+
+For more info on hosproc, see http://puszcza.gnu.org.ua/software/hostproc.
+
 Version 1.1, 2019-08-14
 
 * Display unterminated lines from the command
@@ -27,7 +48,7 @@ Initial release.
 =========================================================================
 Copyright information:
 
-Copyright (C) 2017-2019 Sergey Poznyakoff
+Copyright (C) 2017-2020 Sergey Poznyakoff
 
    Permission is granted to anyone to make or distribute verbatim copies
    of this document as received, in any medium, provided that the
diff --git a/README b/README
index 4279640..0493972 100644
--- a/README
+++ b/README
@@ -148,7 +148,7 @@ the host server.
 
 * Copyright information:
 
-Copyright (C) 2018-2019 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 
    Permission is granted to anyone to make or distribute verbatim copies
    of this document as received, in any medium, provided that the
diff --git a/configure.ac b/configure.ac
index ee9d081..c320da5 100644
--- a/configure.ac
+++ b/configure.ac
@@ -1,11 +1,11 @@
 # This file is part of tallyman                              -*- Autoconf -*-
-# Copyright (C) 2018, 2019 Sergey Poznyakoff
+# Copyright (C) 2018-2020 Sergey Poznyakoff
 # License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 # This is free software: you are free to change and redistribute it.
 # There is NO WARRANTY, to the extent permitted by law.
 
 AC_PREREQ([2.69])
-AC_INIT([tallyman], [1.1], [gray+tallyman@gnu.org])
+AC_INIT([tallyman], [1.2], [gray+tallyman@gnu.org])
 AC_CONFIG_SRCDIR([src/tallyman.c])
 AC_CONFIG_HEADERS([config.h])
 AM_INIT_AUTOMAKE([1.15 foreign])
diff --git a/src/Makefile.am b/src/Makefile.am
index ece3c6f..06068df 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -1,5 +1,5 @@
 # This file is part of tallyman
-# Copyright (C) 2018 Sergey Poznyakoff
+# Copyright (C) 2018-2020 Sergey Poznyakoff
 # License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 # This is free software: you are free to change and redistribute it.
 # There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/config.c b/src/config.c
index 7d2b610..c076a15 100644
--- a/src/config.c
+++ b/src/config.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/defs.h b/src/defs.h
index 96ff9b4..8c5ed7d 100644
--- a/src/defs.h
+++ b/src/defs.h
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/err.c b/src/err.c
index 212c960..51514bf 100644
--- a/src/err.c
+++ b/src/err.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/getdefgw.c b/src/getdefgw.c
index 06b86b5..8e9d655 100644
--- a/src/getdefgw.c
+++ b/src/getdefgw.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/gpl3.h b/src/gpl3.h
index 47947a0..0549875 100644
--- a/src/gpl3.h
+++ b/src/gpl3.h
@@ -1,5 +1,5 @@
 char license[] = "\
-Copyright (C) 2018 Sergey Poznyakoff\n\
+Copyright (C) 2018-2020 Sergey Poznyakoff\n\
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>\n\
 This is free software: you are free to change and redistribute it.\n\
 There is NO WARRANTY, to the extent permitted by law.\n";
diff --git a/src/hostname.c b/src/hostname.c
index db01704..0991a93 100644
--- a/src/hostname.c
+++ b/src/hostname.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/pidfile.c b/src/pidfile.c
index b592ba7..5f670e4 100644
--- a/src/pidfile.c
+++ b/src/pidfile.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/remoteip.c b/src/remoteip.c
index babc688..1322478 100644
--- a/src/remoteip.c
+++ b/src/remoteip.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/runas.c b/src/runas.c
index 62e3992..1cfd0d8 100644
--- a/src/runas.c
+++ b/src/runas.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/servdb.c b/src/servdb.c
index 8d89bd7..1c0c123 100644
--- a/src/servdb.c
+++ b/src/servdb.c
@@ -1,3 +1,9 @@
+/* This file is part of tallyman
+Copyright (C) 2018-2020 Sergey Poznyakoff
+License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+*/
 #include "stevedore.h"
 #include <time.h>
 #include <pthread.h>
diff --git a/src/shttp.c b/src/shttp.c
index 1f82178..9bf88c9 100644
--- a/src/shttp.c
+++ b/src/shttp.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/stevedore.8 b/src/stevedore.8
index 6df55f0..841123d 100644
--- a/src/stevedore.8
+++ b/src/stevedore.8
@@ -1,4 +1,4 @@
-.TH STEVEDORE 8 "July 18, 2018" "TALLYMAN" "Tallyman User Reference"
+.TH STEVEDORE 8 "October 10, 2020" "TALLYMAN" "Tallyman User Reference"
 .SH NAME
 stevedore \- container state collector and SNMP agent daemon
 .SH SYNOPSIS
@@ -102,7 +102,31 @@ to monitor.
 .BI "instance-state-ttl " SECONDS
 Sets the time during which the state of the instance (container) is
 retained in cache. If no update arrives during the specified number of
-seconds, the container is marked as \fBexpired\fR. Default is 30 seconds.
+seconds, the container is marked as \fBexpired\fR. Default is 30
+seconds.
+.SS Hostproc notification
+.B Hostproc
+is an SNMP agent that provides detailed information about processes
+running on a host.  The agent features extensive aggregation capabilities
+that allow the system administrator to obtain various types of metric
+for a group of processes.  Stevedore is able to communicate with
+\fBhostproc\fR and to define process groups for each configured
+service.
+.PP
+Process groups are updated by sending a specially formatted SNMP SET
+request to the IP address of the host running the \fBhostproc\fR
+agent.  Normally, this is the same host where \fBstevedore\fR is
+installed, but that is not required.  The notification is configured
+using the following statement:
+.TP
+\fBhostproc\-server\fR \fIHOST\fB;\fR
+This statement sets the hostname or IP address of the server running
+\fBhostproc\fR.  Optional port can be specified by following the
+argument with a colon and port number.
+.PP
+SNMP credentials for the SET operation are taken from the standard
+.B net\-snmp
+location.
 .SS Syslog configuration
 Unless the program is started in foreground mode (see the \fB\-F\fR
 option), its logging output goes to syslog facility \fBdaemon\fR. The
@@ -221,13 +245,16 @@ Error message associated with this instance if \fBinstanceState\fR is
 \fBerror\fR.     
 .RE
 .SH "SEE ALSO"
-.BR tallyman (1).
+.BR tallyman (1),
+.BR hostproc (8),
+or
+.BR http://puszcza.gnu.org.ua/software/hostproc .
 .SH AUTHORS
 Sergey Poznyakoff
 .SH "BUG REPORTS"
 Report bugs to <gray@gnu.org>.
 .SH COPYRIGHT
-Copyright \(co 2018 Sergey Poznyakoff
+Copyright \(co 2018\-2020 Sergey Poznyakoff
 .br
 .na
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
diff --git a/src/stevedore.c b/src/stevedore.c
index ac95689..0437af9 100644
--- a/src/stevedore.c
+++ b/src/stevedore.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/stevedore.h b/src/stevedore.h
index d189275..66432bb 100644
--- a/src/stevedore.h
+++ b/src/stevedore.h
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/subagent.c b/src/subagent.c
index 34d06ee..6213cba 100644
--- a/src/subagent.c
+++ b/src/subagent.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/tallyman.1 b/src/tallyman.1
index 2b2376f..80d43d9 100644
--- a/src/tallyman.1
+++ b/src/tallyman.1
@@ -1,4 +1,4 @@
-.TH TALLYMAN 1 "August 14, 2019" "TALLYMAN" "Tallyman User Reference"
+.TH TALLYMAN 1 "October 10, 2020" "TALLYMAN" "Tallyman User Reference"
 .SH NAME
 tallyman \- health state collector for docker containers
 .SH SYNOPSIS
@@ -123,7 +123,7 @@ Sergey Poznyakoff
 .SH "BUG REPORTS"
 Report bugs to <gray@gnu.org>.
 .SH COPYRIGHT
-Copyright \(co 2018\-2019 Sergey Poznyakoff
+Copyright \(co 2018\-2020 Sergey Poznyakoff
 .br
 .na
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
diff --git a/src/tallyman.c b/src/tallyman.c
index 44cd18a..7cf6a55 100644
--- a/src/tallyman.c
+++ b/src/tallyman.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018, 2019 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/tallyman.h b/src/tallyman.h
index f972762..e31a3a4 100644
--- a/src/tallyman.h
+++ b/src/tallyman.h
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
diff --git a/src/tallyman_mib.mib2c b/src/tallyman_mib.mib2c
index 7adf3f4..edb6bcf 100644
--- a/src/tallyman_mib.mib2c
+++ b/src/tallyman_mib.mib2c
@@ -1,5 +1,5 @@
 # This file is part of Tallyman -*- c -*-
-# Copyright (C) 2018 Sergey Poznyakoff
+# Copyright (C) 2018-2020 Sergey Poznyakoff
 #
 # Tallyman is free software; you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
diff --git a/src/wrapacl.c b/src/wrapacl.c
index 36c6561..bab7681 100644
--- a/src/wrapacl.c
+++ b/src/wrapacl.c
@@ -1,5 +1,5 @@
 /* This file is part of tallyman
-Copyright (C) 2018 Sergey Poznyakoff
+Copyright (C) 2018-2020 Sergey Poznyakoff
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.