javax.realtime

Class POSIXSignalHandler

java.lang.Object

javax.realtime.POSIXSignalHandler

Deprecated.

since RTSJ 2.0

@Deprecated
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.

POSIX.1-2001 added added a range of realtime signals, ranged from SIGRTMIN and SIGRTMAX.

Since RTSJ2, the methods addHandler(int, javax.realtime.AsyncEventHandler), removeHandler(int, javax.realtime.AsyncEventHandler), and setHandler(int, javax.realtime.AsyncEventHandler) require extra permissions. respectively POSIXPermission.handle, POSIXPermission.handle, and POSIXPermission.override, as well as TaskPermission.control, TaskPermission.override, and TaskPermission.handle.

Field Summary

Fields

Modifier and Type	Field and Description
static int	SIGABRT Deprecated. Abort (ANSI).
static int	SIGALRM Deprecated. Alarm clock (POSIX).
static int	SIGBUS Deprecated. 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 Deprecated. Child status has changed (POSIX).
static int	SIGCLD Deprecated. Same as SIGCHLD (System V), optional signal.
static int	SIGCONT Deprecated. Continue (POSIX), optional signal.
static int	SIGEMT Deprecated. EMT instruction, optional signal.
static int	SIGFPE Deprecated. floating point exception
static int	SIGFREEZE Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGHUP Deprecated. Hangup (POSIX).
static int	SIGILL Deprecated. illegal instruction (ANSI)
static int	SIGINT Deprecated. interrupt (ANSI)
static int	SIGIO Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGIOT Deprecated. IOT instruction (4.2 BSD), optional signal.
static int	SIGKILL Deprecated. 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 Deprecated. 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 Deprecated. quit (POSIX)
static int	SIGSEGV Deprecated. Segmentation violation (ANSI).
static int	SIGSTKFLT Deprecated. Termination (Linux).
static int	SIGSTOP Deprecated. Stop, unblockable (POSIX), optional signal.
static int	SIGSYS Deprecated. Bad system call, optional signal.
static int	SIGTERM Deprecated. Termination (ANSI).
static int	SIGTHAW Deprecated. RTSJ V1.0.1 not part of POSIX 9945-1-1996 standard
static int	SIGTRAP Deprecated. trace trap (POSIX), optional signal.
static int	SIGTSTP Deprecated. Keyboard stop (POSIX), optional signal.
static int	SIGTTIN Deprecated. Background read from tty (POSIX), optional signal.
static int	SIGTTOU Deprecated. 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 Deprecated. User-defined signal 1 (POSIX).
static int	SIGUSR2 Deprecated. 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

Method Summary

Modifier and Type	Method and Description
static void	addHandler(int signal_id, AsyncEventHandler handler) Deprecated. addHandler adds the handler provided to the set of handlers that will be released on the provided signal.
static void	removeHandler(int signal_id, AsyncEventHandler handler) Deprecated. removeHandler removes a handler that was added for a given signal.
static void	setHandler(int signal_id, AsyncEventHandler handler) Deprecated. 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

Deprecated.

Hangup (POSIX).

SIGINT

public static final int SIGINT

Deprecated.

interrupt (ANSI)

SIGQUIT

public static final int SIGQUIT

Deprecated.

quit (POSIX)

SIGILL

public static final int SIGILL

Deprecated.

illegal instruction (ANSI)

SIGTRAP

public static final int SIGTRAP

Deprecated.

trace trap (POSIX), optional signal.

SIGABRT

public static final int SIGABRT

Deprecated.

Abort (ANSI).

SIGBUS

public static final int SIGBUS

Deprecated.

BUS error (4.2 BSD), optional signal.

SIGFPE

public static final int SIGFPE

Deprecated.

floating point exception

SIGKILL

public static final int SIGKILL

Deprecated.

Kill, unblockable (POSIX).

SIGUSR1

public static final int SIGUSR1

Deprecated.

User-defined signal 1 (POSIX).

SIGSEGV

public static final int SIGSEGV

Deprecated.

Segmentation violation (ANSI).

SIGUSR2

public static final int SIGUSR2

Deprecated.

User-defined signal 2 (POSIX).

SIGPIPE

public static final int SIGPIPE

Deprecated.

Broken pipe (POSIX).

SIGALRM

public static final int SIGALRM

Deprecated.

Alarm clock (POSIX).

SIGTERM

public static final int SIGTERM

Deprecated.

Termination (ANSI).

SIGSTKFLT

public static final int SIGSTKFLT

Deprecated.

Termination (Linux).

SIGCHLD

public static final int SIGCHLD

Deprecated.

Child status has changed (POSIX).

SIGCONT

public static final int SIGCONT

Deprecated.

Continue (POSIX), optional signal.

SIGSTOP

public static final int SIGSTOP

Deprecated.

Stop, unblockable (POSIX), optional signal.

SIGTSTP

public static final int SIGTSTP

Deprecated.

Keyboard stop (POSIX), optional signal.

SIGTTIN

public static final int SIGTTIN

Deprecated.

Background read from tty (POSIX), optional signal.

SIGTTOU

public static final int SIGTTOU

Deprecated.

Background write to tty (POSIX), optional signal.

SIGURG

@Deprecated
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

@Deprecated
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

@Deprecated
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

@Deprecated
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

@Deprecated
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

@Deprecated
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

@Deprecated
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

@Deprecated
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

Deprecated.

Bad system call, optional signal.

SIGIOT

public static final int SIGIOT

Deprecated.

IOT instruction (4.2 BSD), optional signal.

SIGPOLL

@Deprecated
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

Deprecated.

Same as SIGCHLD (System V), optional signal.

SIGEMT

public static final int SIGEMT

Deprecated.

EMT instruction, optional signal.

SIGLOST

@Deprecated
public static final int SIGLOST

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

SIGCANCEL

@Deprecated
public static final int SIGCANCEL

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

SIGFREEZE

@Deprecated
public static final int SIGFREEZE

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

SIGLWP

@Deprecated
public static final int SIGLWP

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

SIGTHAW

@Deprecated
public static final int SIGTHAW

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

SIGWAITING

@Deprecated
public static final int SIGWAITING

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

Method Detail

addHandler

public static void addHandler(int signal_id,
                              AsyncEventHandler handler)

Deprecated.

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

Throws:

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

Parameters:

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

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

removeHandler

public static void removeHandler(int signal_id,
                                 AsyncEventHandler handler)

Deprecated.

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

Throws:

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

Parameters:

signal_id - 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.

setHandler

public static void setHandler(int signal_id,
                              AsyncEventHandler handler)

Deprecated.

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.

Throws:

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

Parameters:

signal_id - 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.