readme

用来编写 unix 环境下的守护程序的工具库

                                 libdaemon 0.12

   Copyright 2003-2007 Lennart Poettering <mzqnrzba (at) 0pointer (dot)
   de>
     * [1]License
     * [2]News
     * [3]Overview
     * [4]Current Status
     * [5]Documentation
     * [6]Requirements
     * [7]Installation
     * [8]Acknowledgements
     * [9]Download

License

   This library is free software; you can redistribute it and/or modify it
   under the terms of the GNU Lesser General Public License as published
   by the Free Software Foundation; either version 2.1 of the License, or
   (at your option) any later version.

   This library is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
   General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with this library; if not, write to the Free Software
   Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
   USA

News

   Tue Jul 10 2007:

   [10]Version 0.12 released; changes include: make daemon_close_all()
   actually work properly.

   Fri Jun 22 2007:

   [11]Version 0.11 released; changes include: automatically detect
   whether lynx is installed; properly set errno on every error condition;
   add new function daemon_close_all() to close all open file descriptors
   except a given set; add daemon_logv(), which is identical to
   daemon_log(), but takes a va_list argument; add daemon_execv() in
   similar style; other fixes

   Thu Nov 24 2005:

   [12]Version 0.10 released; changes include: make logging compatible
   with daemons running in a chroot() environment

   Fri Nov 18 2005:

   [13]Version 0.9 released; changes include: portability (FreeBSD,
   NetBSD, OpenBSD, Darwin, Solaris, Cygwin); some minor header file
   cleanups; fix access mode of PID files; other cleanups; license change
   from GPL to LGPL

   Sat Jun 4 2005:

   [14]Version 0.8 released; changes include: proper PID file locking

   Sat Dec 18 2004:

   [15]Version 0.7 released; changes include: minor cleanups; C++
   compatibility; gcc 2.95 compatiblity

   Wed Apr 7 2004:

   [16]Version 0.6 released; changes include: backgrounding fixes, minor
   other stuff

   Tue Feb 10 2004:

   [17]Version 0.5 released; changes include: signal handling fix, forking
   fix

   Sat Jan 10 2004:

   [18]Version 0.4 released; changes include: new module dexec.c; added
   pkg-config support.

   Mon Oct 20 2003:

   [19]Version 0.3 released; changes include: documentation update, build
   fixes, RPM spec file added, added new function int
   daemon_pid_file_kill_wait().

   Thu July 10 2003:

   [20]Version 0.2 released; changes include: ugly umask error fix,
   documentation update

   Mon July 7 2003:

   [21]Version 0.1 released

Overview

   libdaemon is a lightweight C library that eases the writing of UNIX
   daemons. It consists of the following parts:
     * A wrapper around fork() which does the correct daemonization
       procedure of a process
     * A wrapper around syslog() for simpler and compatible log output to
       Syslog or STDERR
     * An API for writing PID files
     * An API for serializing UNIX signals into a pipe for usage with
       select() or poll()
     * An API for running subprocesses with STDOUT and STDERR redirected
       to syslog.

   APIs like these are used in most daemon software available. It is not
   that simple to get it done right and code duplication is not a goal.

   libdaemon is currently used by [22]ifplugd, [23]Avahi, [24]ivam2,
   [25]Nautilus-Share and [26]aeswepd.

Current Status

   Version 0.12 is feature complete.

Documentation

   An extensive API reference is [27]available

Requirements

   libdaemon was developed and tested on Debian GNU/Linux "testing" from
   July 2003, it should work on most other Linux distributions (and some
   Unix versions) since it uses GNU Autoconf and GNU libtool for source
   code configuration and shared library management.

   libdaemon is known to work on modern Linux systems, FreeBSD, NetBSD,
   OpenBSD, Darwin, Solaris and Windows/Cygwin.

Installation

   As this package is made with the GNU autotools you should run
   ./configure inside the distribution directory for configuring the
   source tree. After that you should run make for compilation and make
   install (as root) for installation of libdaemon.

   Please use gmake instead of traditional make for compilation on
   non-Linux systems.

Acknowledgements

   Sebastien Estienne, for a lot of portability work.

Download

   The newest release is always available from
   [28]http://0pointer.de/lennart/projects/libdaemon/

   Get libdaemon's development sources from the [29]Subversion
   [30]repository ([31]viewcvs):
svn checkout svn://svn.0pointer.de/libdaemon/trunk libdaemon

   You may find an up to date Debian package of libdaemon on the
   [32]Debian package repository.

   If you want to be notified whenever I release a new version of this
   software use the subscription feature of [33]Freshmeat.
     __________________________________________________________________


    Lennart Poettering <mzqnrzba (at) 0pointer (dot) de>, July 2007

   $Id: README.html.in 129 2007-07-10 17:48:11Z lennart $

References

   1. README#license
   2. README#news
   3. README#overview
   4. README#status
   5. README#documentation
   6. README#requirements
   7. README#installation
   8. README#acks
   9. README#download
  10. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.12.tar.gz
  11. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.11.tar.gz
  12. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.10.tar.gz
  13. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.9.tar.gz
  14. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.8.tar.gz
  15. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.7.tar.gz
  16. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.6.tar.gz
  17. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.5.tar.gz
  18. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.4.tar.gz
  19. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.3.tar.gz
  20. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.2.tar.gz
  21. http://0pointer.de/lennart/projects/libdaemon/libdaemon-0.1.tar.gz
  22. http://0pointer.de/lennart/projects/ifplugd/
  23. http://freedesktop.org/Software/Avahi
  24. http://0pointer.de/lennart/projects/ivam2/
  25. http://gentoo.ovibes.net/nautilus-share/mediawiki-1.4.4/index.php/Accueil
  26. http://0pointer.de/lennart/projects/aeswepd/
  27. reference/html/index.html
  28. http://0pointer.de/lennart/projects/libdaemon/
  29. http://subversion.tigris.org/
  30. svn://svn.0pointer.de/libdaemon
  31. http://0pointer.de/cgi-bin/viewcvs.cgi/?root=libdaemon
  32. http://packages.debian.org/libdaemon0
  33. http://freshmeat.net/projects/libdaemon/