My favorites | Sign in
Project Home Downloads Issues Source
READ-ONLY: This project has been archived. For more information see this post.
Project Information

What is this?

muddog is a simple utility that monitors and manages processes for high availability. It launches specified server applications based on a given configuration, and restores the process when it is aborted abnormally.

How to use?

Please see muddog.8 man page.

MUDDOG(8)                 BSD System Manager's Manual                MUDDOG(8)

     muddog — process “super-server”

     muddog [-d] [-P filename] [-v] [configuration file]

     The muddog utility a simple utility to monitor and manage processes for
     High Availability.  It launches specified server application based on
     configuration and restore the process when it's aborted abnormally.

     The following options are available:

     -d      Turn on debugging.

     -P      Specify an alternate file in which to store the process ID.

     -v      Show the version.

     Upon execution, muddog reads its configuration information from a config‐
     uration file which, by default, is /etc/muddog.conf.  There must be an
     entry for each field of the configuration file, with entries for each
     field separated by a tab or a space.  Comments are denoted by a “#” at
     the beginning of a line.  There must be an entry for each field.  The
     fields of the configuration file are as follows:


     The service-name entry is an identifier to specify the entry.

     The user entry should contain the user name of the user as whom the
     server should run.  This allows for servers to be given less permission
     than root.  The optional group part separated by “:” allows a group name
     other than the default group for this user to be specified.

     The server-program entry should contain the pathname of the program which
     is to be executed by muddog when the program is launched or SIGHUP signal
     is received.  Please note that server-program should not call daemon(3)
     function internally because muddog will execute server-program again due
     to SIGCHLD signal got.

     The server-program-arguments entry lists the arguments to be passed to
     the server-program, starting with argv[0], which usually is the name of
     the program.

     /etc/muddog.conf    configuration file muddog

     Here are several example service entries for the various types of ser‐

     varnishd root  /usr/sbin/varnishd  varnishd -F

     The muddog server logs error messages using syslog(3).  Important error
     messages and their explanations are:

     service: No such user user, service ignored
     service: getpwnam: user: No such user
     No entry for user exists in the passwd(5) database.  The first message
     occurs when muddog (re)reads the configuration file.  The second message
     occurs when the service is invoked.

     service: can't set uid uid
     service: can't set gid gid
     The user or group ID for the entry's user field is invalid.

     The muddog utility written based on FreeBSD inetd(8).

BSD                            November 9, 2012                            BSD

Supported OS

  • Linux
  • FreeBSD
Powered by Google Project Hosting