add page

1 files changed, 46 insertions, 0 deletions

diff --git a/projects/whatmaps.mdwn b/projects/whatmaps.mdwn
new file mode 100644
index 0000000..7acb880
--- /dev/null
+++ b/projects/whatmaps.mdwn
@@ -0,0 +1,46 @@
+After a security upgrade 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 supports Debian and has basic support for RPM based distributions.
+
+[[!toc ]]
+
+## Installation
+* Since it's a single script you can either use the script right away or call:
+
+        python setup.py
+ 
+  to install it. You can also build a debian package from the 'debian/master' branch.
+
+## Usage
+Simply 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 'krb5-auth-dialog' for '['/usr/bin/krb5-auth-dialog']' - restart manually
+    WARNING: No service script found in 'openssh-client' for '['/usr/bin/ssh-agent']' - restart manually
+    WARNING: No service script found in 'vim-gnome' for '['/usr/bin/vim.gnome']' - restart manually
+    WARNING: No service script found in 'isc-dhcp-client' for '['/sbin/dhclient']' - restart manually
+    WARNING: No service script found in 'wpasupplicant' for '['/sbin/wpa_supplicant']' - restart manually
+    Services that possibly need to be restarted:
+    postfix
+    libvirt-bin
+    ntpd
+
+Note that the processes [[whatmaps]] warns about above are packages without any init scripts (e.g. started by a desktop session). They need to be restarted manually at the moment. The services found by [[whatmaps]] can be restarted using the *--restart* option.
+
+<a href="https://flattr.com/thing/48104/Sigxcpu-org-projects" target="_blank">
+<img src="http://api.flattr.com/button/button-compact-static-100x17.png" alt="Flattr this" title="Flattr this" border="0" /></a>
+
+## Source Code
+The source code is available via:
+
+    git clone git://honk.sigxcpu.org/git/whatmaps.git/
+
+## TODO
+* apt integration: it's there but needs more testing
+* support for other init systems besides SysV-RC
+* more reliable mapping between processes and init scripts
+* finish Fedora support