`hdaemonize-0.5.0` ================= `hdaemonize` is a simple library that hides some of the complexities of writing UNIX daemons in Haskell. Obtaining ----------- The latest version is available (BSD license) at [GitHub](https://github.com/madhadron/hdaemonize). Using ------- The synopsis is: import System.Posix.Daemonize main = daemonize $ program This code will make `program` do what good daemons should do, that is, detach from the terminal, close file descriptors, create a new process group, and so on. If you want more functionality than that, it is available as a `serviced` function. Here is an example: import Control.Concurrent import System.Posix.Daemonize loop i log = do threadDelay $ 10^6 log (show i) writeFile "/tmp/counter" $ show i if i == 5 then undefined else loop (i + 1) log main = serviced (loop 0) Let us say this program is compiled as `mydaemon`. Then: # mydaemon start starts the service. A second call to start will complain that the program is already running. During its execution, mydaemon will simply write a new number to `/tmp/counter` every second, until it reaches 5. Then, an exception will be thrown. This exception will be caught by `hdaemonize`, and logged to `/var/log/daemon.log` or similar (this is depends on how `syslog` works on your platorm). `log (show i)` will leave messages in the same file. When the exception is thrown, the program will be restared in 5 seconds, and will start counting from 0 again. The following commands are also made available: # mydaemon stop # mydaemon restart Finally, `mydaemon` drops privileges. By default it changes the effective user and group ids to those of the `daemon` user, but it prefers to use those of `mydaemon`, if present. Changelog --------- * 0.5 * added support for hsyslog 2.0 * add configurable time between SIGTERM and SIGKILL when shutting down * 0.4 * added support for a privileged action before dropping privileges * 0.3 * merged with updates by madhadron * 0.2 * provided documentation * backported to older GHC versions, tested on 6.8.1 * 0.1 * initial public release Authors ------- Anton Tayanovskyy <name.surname@gmail.com>, bug reports and feature requests welcome. The code is originally based on a public posting by [Andre Nathan](http://sneakymustard.com/), used by permission.