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 callingprocess’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 beenclosed, 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 threadsare running.Normary, file descriptors 0, 1 and 2 are correspond to stdin, stdout andstderr. However, even if any of these file discriptors refer to somethingelse, they will still be closed when argument ‘noclose’ is False.It is a good idea to call this function before creating any threads andbefore 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)
| 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 |