javax.realtime
Class POSIXSignalHandler

java.lang.Object
  javax.realtime.POSIXSignalHandler

public final class POSIXSignalHandler
extends Object

Jamaica Real-Time Specification for Java class POSIXSignalHandler.

This class permits the use of an AsyncEventHandler to react on the occurrence of POSIX signals.

On systems that support POSIX signals fully, the 13 signals required by POSIX will be supported. Any further signals defined in this class may be supported by the system. On systems that do not support POSIX signals, even the 13 standard signals may never be fired.

Field Summary

static int	SIGABRT Abort (ANSI).
static int	SIGALRM Alarm clock (POSIX).
static int	SIGBUS BUS error (4.2 BSD), optional signal.
static int	SIGCANCEL Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGCHLD Child status has changed (POSIX).
static int	SIGCLD Same as SIGCHLD (System V), optional signal.
static int	SIGCONT Continue (POSIX), optional signal.
static int	SIGEMT EMT instruction, optional signal.
static int	SIGFPE floating point exception
static int	SIGFREEZE Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGHUP Hangup (POSIX).
static int	SIGILL illegal instruction (ANSI)
static int	SIGINT interrupt (ANSI)
static int	SIGIO Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGIOT IOT instruction (4.2 BSD), optional signal.
static int	SIGKILL Kill, unblockable (POSIX).
static int	SIGLOST Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGLWP Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGPIPE Broken pipe (POSIX).
static int	SIGPOLL Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGPROF Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGPWR Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGQUIT quit (POSIX)
static int	SIGSEGV Segmentation violation (ANSI).
static int	SIGSTOP Stop, unblockable (POSIX), optional signal.
static int	SIGSYS Bad system call, optional signal.
static int	SIGTERM Termination (ANSI).
static int	SIGTHAW Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGTRAP trace trap (POSIX), optional signal.
static int	SIGTSTP Keyboard stop (POSIX), optional signal.
static int	SIGTTIN Background read from tty (POSIX), optional signal.
static int	SIGTTOU Background write to tty (POSIX), optional signal.
static int	SIGURG Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGUSR1 User-defined signal 1 (POSIX).
static int	SIGUSR2 User-defined signal 2 (POSIX).
static int	SIGVTALRM Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGWAITING Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGWINCH Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGXCPU Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGXFSZ Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

Constructor Summary

POSIXSignalHandler()

Method Summary

static void	addHandler(int signal, AsyncEventHandler handler) addHandler adds the handler provided to the set of handlers that will be released on the provided signal.
static void	removeHandler(int signal, AsyncEventHandler handler) removeHandler removes a handler that was added for a given signal.
static void	setHandler(int signal, AsyncEventHandler handler) setHandler sets the set of handlers that will be released on the provided signal to the set with the provided handler being the single element.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SIGHUP

public static final int SIGHUP

Hangup (POSIX).

SIGINT

public static final int SIGINT

interrupt (ANSI)

SIGQUIT

public static final int SIGQUIT

quit (POSIX)

SIGILL

public static final int SIGILL

illegal instruction (ANSI)

SIGTRAP

public static final int SIGTRAP

trace trap (POSIX), optional signal.

SIGABRT

public static final int SIGABRT

Abort (ANSI).

SIGBUS

public static final int SIGBUS

BUS error (4.2 BSD), optional signal.

SIGFPE

public static final int SIGFPE

floating point exception

SIGKILL

public static final int SIGKILL

Kill, unblockable (POSIX).

SIGUSR1

public static final int SIGUSR1

User-defined signal 1 (POSIX).

SIGSEGV

public static final int SIGSEGV

Segmentation violation (ANSI).

SIGUSR2

public static final int SIGUSR2

User-defined signal 2 (POSIX).

SIGPIPE

public static final int SIGPIPE

Broken pipe (POSIX).

SIGALRM

public static final int SIGALRM

Alarm clock (POSIX).

SIGTERM

public static final int SIGTERM

Termination (ANSI).

SIGCHLD

public static final int SIGCHLD

Child status has changed (POSIX).

SIGCONT

public static final int SIGCONT

Continue (POSIX), optional signal.

SIGSTOP

public static final int SIGSTOP

Stop, unblockable (POSIX), optional signal.

SIGTSTP

public static final int SIGTSTP

Keyboard stop (POSIX), optional signal.

SIGTTIN

public static final int SIGTTIN

Background read from tty (POSIX), optional signal.

SIGTTOU

public static final int SIGTTOU

Background write to tty (POSIX), optional signal.

SIGURG

public static final int SIGURG

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

Urgent condition on socket (4.2 BSD).

SIGXCPU

public static final int SIGXCPU

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

CPU limit exceeded (4.2 BSD).

SIGXFSZ

public static final int SIGXFSZ

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

File size limit exceeded (4.2 BSD).

SIGVTALRM

public static final int SIGVTALRM

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

Virtual alarm clock (4.2 BSD).

SIGPROF

public static final int SIGPROF

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

Profiling alarm clock (4.2 BSD).

SIGWINCH

public static final int SIGWINCH

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

Window size change (4.3 BSD, Sun).

SIGIO

public static final int SIGIO

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

I/O now possible (4.2 BSD).

SIGPWR

public static final int SIGPWR

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

Power failure restart (System V).

SIGSYS

public static final int SIGSYS

Bad system call, optional signal.

SIGIOT

public static final int SIGIOT

IOT instruction (4.2 BSD), optional signal.

SIGPOLL

public static final int SIGPOLL

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

Pollable event occurred (System V).

SIGCLD

public static final int SIGCLD

Same as SIGCHLD (System V), optional signal.

SIGEMT

public static final int SIGEMT

EMT instruction, optional signal.

SIGLOST

public static final int SIGLOST

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

SIGCANCEL

public static final int SIGCANCEL

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

SIGFREEZE

public static final int SIGFREEZE

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

SIGLWP

public static final int SIGLWP

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

SIGTHAW

public static final int SIGTHAW

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

SIGWAITING

public static final int SIGWAITING

Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard

Constructor Detail

POSIXSignalHandler

public POSIXSignalHandler()

Method Detail

addHandler

public static void addHandler(int signal,
                              AsyncEventHandler handler)

addHandler adds the handler provided to the set of handlers that will be released on the provided signal.

Parameters:

signal - The POSIX signal as defined in the constants SIG*.

handler - the handler to be released on the given signal.

Throws:

IllegalArgumentException - iff signal is not defined by any of the constants in this class or handler is null.

removeHandler

public static void removeHandler(int signal,
                                 AsyncEventHandler handler)

removeHandler removes a handler that was added for a given signal.

Parameters:

signal - The POSIX signal as defined in the constants SIG*.

handler - the handler to be removed from the given signal. If this handler is null or has not been added to the signal, nothing will happen.

Throws:

IllegalArgumentException - iff signal is not defined by any of the constants in this class.

setHandler

public static void setHandler(int signal,
                              AsyncEventHandler handler)

setHandler sets the set of handlers that will be released on the provided signal to the set with the provided handler being the single element.

Parameters:

signal - The POSIX signal as defined in the constants SIG*.

handler - the handler to be released on the given signal, null to remove all handlers for the given signal.

Throws:

IllegalArgumentException - iff signal is not defined by any of the constants in this class.