Poster of Linux kernelThe best gift for a Linux geek
dsignal.h

dsignal.h

Section: libdaemon (3) Updated: 2 Feb 2010
Local index Up
 

NAME

dsignal.h -

Contains the API for serializing signals to a pipe for usage with select() or poll().

 

SYNOPSIS


 

Functions


int daemon_signal_init (int s,...)
Installs signal handlers for the specified signals.
int daemon_signal_install (int s)
Install a signal handler for the specified signal.
void daemon_signal_done (void)
Free resources of signal handling, should be called before daemon exit.
int daemon_signal_next (void)
Return the next signal received.
int daemon_signal_fd (void)
Return the file descriptor the daemon should select() on for reading.  

Detailed Description

Contains the API for serializing signals to a pipe for usage with select() or poll().

You should register all signals you wish to handle with select() in your main loop with daemon_signal_init() or daemon_signal_install(). After that you should sleep on the file descriptor returned by daemon_signal_fd() and get the next signal received with daemon_signal_next(). You should call daemon_signal_done() before exiting.

Definition in file dsignal.h.  

Function Documentation

 

void daemon_signal_done (void)

Free resources of signal handling, should be called before daemon exit.

Examples: testd.c.  

int daemon_signal_fd (void)

Return the file descriptor the daemon should select() on for reading. Whenever the descriptor is ready you should call daemon_signal_next() to get the next signal queued.

Returns:

The file descriptor or negative on failure

Examples: testd.c.  

int daemon_signal_init (int s, ...)

Installs signal handlers for the specified signals. Parameters:

s,... The signals to install handlers for. The list should be terminated by 0

Returns:

zero on success, nonzero on failure

Examples: testd.c.  

int daemon_signal_install (int s)

Install a signal handler for the specified signal. Parameters:

s The signalto install handler for

Returns:

zero onsuccess,nonzero on failure

 

int daemon_signal_next (void)

Return the next signal received. This function will not block. Instead it returns 0 if no signal is queued.

Returns:

The next queued signal if one is queued, zero if none is queued, negative on failure.

Examples: testd.c.  

Author

Generated automatically by Doxygen for libdaemon from the source code.


 

Index

NAME
SYNOPSIS
Functions
Detailed Description
Function Documentation
void daemon_signal_done (void)
int daemon_signal_fd (void)
int daemon_signal_init (int s, ...)
int daemon_signal_install (int s)
int daemon_signal_next (void)
Author

This document was created by man2html, using the manual pages.
Time: 21:45:19 GMT, April 16, 2011