diff options
author | Guido Günther <agx@sigxcpu.org> | 2014-04-18 14:23:48 +0200 |
---|---|---|
committer | Guido Günther <agx@sigxcpu.org> | 2014-04-18 14:57:52 +0200 |
commit | 98bdda0e2e0fe182857ebb7f56b86193c2a9e7d3 (patch) | |
tree | 80c53a49986fc0efc1f43fe2f325b9bbb26c36e1 | |
parent | 2db247f179c3ab0f350bb3c9848ccc990ad761bc (diff) |
Add manpage in pod formatv0.0.5
-rw-r--r-- | man/whatmaps.pod | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/man/whatmaps.pod b/man/whatmaps.pod new file mode 100644 index 0000000..408e75d --- /dev/null +++ b/man/whatmaps.pod @@ -0,0 +1,43 @@ +=head1 NAME + +whatmaps - Find and restart services after library upgrades + +=head1 SYNOPSIS +=encoding utf8 + +B<whatmaps> [--restart] [--print-cmds=I<FILE>] pkg1 [pkg2 pkg3 ...] + +=head1 DESCRIPTION + +B<whatmaps> tries to find a list of services that need to be restarted +after a library upgrade because they map that particular library into +their address space. It does this by extracting a list of shared +objects from the packages given on the command line. It then looks at +the list of running processes to find those that map the shared +objects and uses the distributions package manager to find out the +packages that ship them. It then prints a list of services in these +packages that likely need to be restarted. + +By default it assumes all services in the found packages need a restart but it +also keeps a internal distribution specific list of exceptions. + +If the I<--restart> option is given, the services are restarted without any +prompting and with the I<--prind-cmds> option the restart commands are written to +a file for later execution. + +On Debian systems B<whatmaps> can also be run automatically by apt-get. See +L</usr/share/doc/whatmaps/README.Debian> for details. + +=head1 SEE ALSO + +apt(8) + +The latest version is available at +L<https://honk.sigxcpu.org/piki/projects/whatmaps/>. + +=head1 AUTHOR + +Guido Günther <agx@sigxcpu.org> + +=cut + |