Skip to main content

unix_daemon

unix_daemon is a python module emulating BSD daemon(3).
This module provides a function named daemon.
If this function is called, the process become a daemon and start to run
background.

Requirements

  • Python 2.6 or later, or Python 3.x

  • Unix or Linux platform.

Test

  • Python 2.6.9

  • Python 2.7.8

  • Python 3.1.5

  • Python 3.2.5

  • Python 3.3.5

  • Python 3.4.1

Setup

  • Install using pip

    $ sudo pip install unix_daemon
  • Install from git.

    $ git clone https://github.com/wbcchsyn/unix_daemon.git
    $ cd unix_daemon
    $ sudo python setup.py install

Usage

unix_daemon.daemon(nochdir=False, noclose=False)

Make process daemon and start to run in the background.

Arguments
If argument 1 ‘nochdir’ is False, the process changes the calling
process’s current working directory to the root directory (“/”);
otherwise, the current working directory is left unchanged.
The default value of the nochdir is False.
If argument 2 ‘noclose’ is False, this function close file descriptors 0,
1 and 2 and redirect them to /dev/null. Even if some of them have been
closed, this function open these file descriptors and redirect to
/dev/null if noclose is False.
The defult value of noclose is False.
Return Value

daemon returns the pid of new process.

Note
This function calls os.fork() internally to detach tty safely.
Be careful to call this function when two or more than two python threads
are running.
Normary, file descriptors 0, 1 and 2 are correspond to stdin, stdout and
stderr. However, even if any of these file discriptors refer to something
else, they will still be closed when argument ‘noclose’ is False.
It is a good idea to call this function before creating any threads and
before opening any files or sockets.
Example

Call unix_daemon.daemon(), then the process starts to run in the backgrond.

import unix_daemon
import os

print('pid: %s\n' % os.getpid())

pid = unix_daemon.daemon()
with open('/tmp/foo', 'a') as f:
    print('pid: %s\n' % os.getpid())
    f.write('new pid: %s\n' % pid)

You can see the process id changes and the 2nd print is not displayed.

Development

Install requirements to developing copy pre-commit hook from repository.

$ git clone https://github.com/wbcchsyn/unix_daemon.git
$ cd unix_daemon
$ pip install -r dev_utils/requirements.txt
$ ln -s ../../dev_utils/pre-commit .git/hooks/pre-commit

Metadata

Release files for unix_daemon 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for unix_daemon 1.0.0
File Size Uploaded
unix_daemon-1.0.0.tar.gz 3.5 kB Details

Release files / unix_daemon-1.0.0.tar.gz

Download URL unix_daemon-1.0.0.tar.gz
Size 3.5 kB
Tags Source
SHA-256 checksum
How to use checksums
a34c4ca03cfac914a768d1b4047d9c756a674cadbb3c622a1e86951fef560d51
BLAKE2b-256 checksum
How to use checksums
09e05298090b410017276bbb7b0b3e71f8ed7460501f527a35f2201105b8216b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.0.0 This release

1 release file

0.1.4

1 release file

0.1.3

3 release files

0.1.1

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page