summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorGuido Günther <agx@sigxcpu.org>2014-04-08 21:39:00 +0200
committerGuido Günther <agx@sigxcpu.org>2014-04-08 21:40:46 +0200
commit72bf838de4f518f01a0d3ac0fefc53bfff332ec8 (patch)
tree2ff1ec4e9aef3434160f4616e4e29076e035dd72 /README
parentb8577115bb6482d437c308772a3fe7d21d1ba60f (diff)
Update README a bit
Diffstat (limited to 'README')
-rw-r--r--README34
1 files changed, 34 insertions, 0 deletions
diff --git a/README b/README
index 2a191f7..c35fe66 100644
--- a/README
+++ b/README
@@ -1,3 +1,37 @@
+After a security update of a library one needs to restart all programs that
+make use of this library in order for the security update to become effective.
+whatmaps takes a package name and looks (on Linux systems) in /proc/pid/maps
+for processes that map shared objects contained in a certain package. It then
+looks for the corresponding processes to find the services that need to be
+restarted.
+
+It currently supports Debian and Fedora but might also work well on other
+Debian or RPM based distributions.
+
+Usage
+=====
+Pass the names of the packages that had shared objects updated:
+
+ whatmaps <pkg1> <pkg2>
+
+The example output looks like:
+
+ # whatmaps libssl0.9.8
+ WARNING: No service script found in 'wpasupplicant' for '['/sbin/wpa_supplicant']' - restart manually
+ Services that possibly need to be restarted:
+ postfix
+ libvirt-bin
+ ntpd
+
+Apt Integration
+===============
+
+To enable automatic restarts during security updates on Debian based systems set:
+
+ Whatmaps::Enable-Restart "1";
+
+in /etc/apt/apt.conf.d/20services.
+
See
https://honk.sigxcpu.org/piki/projects/whatmaps/