APIdia Launch Partner
Top Description Inners Fields Constructors Methods
sun.misc

public final Class Signal

extends Object
Class Inheritance
Imports
java.util.Objects

This class provides ANSI/ISO C signal support. A Java program can register signal handlers for the current process. There are two restrictions:

Signal objects are created based on their names. For example:

new Signal("INT");
constructs a signal object corresponding to SIGINT, which is typically produced when the user presses Ctrl-C at the command line. The Signal constructor throws IllegalArgumentException when it is passed an unknown signal.

This is an example of how Java code handles SIGINT:

SignalHandler handler = new SignalHandler () {
    public void handle(Signal sig) {
      ... // handle SIGINT
    }
};
Signal.handle(new Signal("INT"), handler);
Authors
Sheng Liang, Bill Shannon
Since
1.2
See Also
sun.misc.SignalHandler

Nested and Inner Type Summary

Modifier and TypeClass and Description
pack-priv static class
pack-priv static class

Field Summary

Modifier and TypeField and Description
private final Signal

Constructor Summary

AccessConstructor and Description
public
Signal(String
the name of the signal.
name
)

Constructs a signal from its name.

Method Summary

Modifier and TypeMethod and Description
public boolean

Returns:

whether two Signal objects are equal.
equals
(Object
the object to compare with.
other
)

Overrides java.lang.Object.equals.

Compares the equality of two Signal objects.

public String

Returns:

the name of the signal.
getName
()

Returns the signal name.

public int
public static synchronized SignalHandler

Returns:

the old handler
handle
(Signal
a signal
sig
,
SignalHandler
the handler to be registered with the given signal.
handler
)

Registers a signal handler.

public int

Returns:

a hash code value for this object.
hashCode
()

Overrides java.lang.Object.hashCode.

Returns a hashcode for this Signal.

public static void
raise(Signal
a signal
sig
)

Raises a signal in the current process.

public String

Returns:

a string representation of the signal
toString
()

Overrides java.lang.Object.toString.

Returns a string representation of this signal.

Inherited from java.lang.Object:
clonefinalizegetClassnotifynotifyAllwaitwaitwait

Field Detail

iSignalback to summary
private final Signal iSignal

Constructor Detail

Signalback to summary
public Signal(String name)

Constructs a signal from its name.

Parameters
name:String

the name of the signal.

Exceptions
IllegalArgumentException:
unknown signal
See Also
sun.misc.Signal#getName()

Method Detail

equalsback to summary
public boolean equals(Object other)

Overrides java.lang.Object.equals.

Compares the equality of two Signal objects.

Parameters
other:Object

the object to compare with.

Returns:boolean

whether two Signal objects are equal.

getNameback to summary
public String getName()

Returns the signal name.

Returns:String

the name of the signal.

See Also
sun.misc.Signal#Signal(String name)
getNumberback to summary
public int getNumber()
handleback to summary
public static synchronized SignalHandler handle(Signal sig, SignalHandler handler) throws IllegalArgumentException

Registers a signal handler.

Parameters
sig:Signal

a signal

handler:SignalHandler

the handler to be registered with the given signal.

Returns:SignalHandler

the old handler

Exceptions
IllegalArgumentException:
the signal is in use by the VM
See Also
sun.misc.Signal#raise(Signal sig), sun.misc.SignalHandler, sun.misc.SignalHandler#SIG_DFL, sun.misc.SignalHandler#SIG_IGN
hashCodeback to summary
public int hashCode()

Overrides java.lang.Object.hashCode.

Returns a hashcode for this Signal.

Returns:int

a hash code value for this object.

raiseback to summary
public static void raise(Signal sig) throws IllegalArgumentException

Raises a signal in the current process.

Parameters
sig:Signal

a signal

See Also
sun.misc.Signal#handle(Signal sig, SignalHandler handler)
toStringback to summary
public String toString()

Overrides java.lang.Object.toString.

Returns a string representation of this signal. For example, "SIGINT" for an object constructed using new Signal ("INT").

Returns:String

a string representation of the signal

sun.misc back to summary

pack-priv final Class Signal.InternalMiscHandler

extends Object
implements Handler
Class Inheritance
All Implemented Interfaces
jdk.internal.misc.Signal.Handler

Field Summary

Modifier and TypeField and Description
private final SignalHandler
private final Signal

Constructor Summary

AccessConstructor and Description
private

Method Summary

Modifier and TypeMethod and Description
public void
handle(Signal ignore)

Implements jdk.internal.misc.Signal.Handler.handle.

Handle the given signal

pack-priv static Signal.Handler
of(Signal signal, SignalHandler handler)

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

handlerback to summary
private final SignalHandler handler
signalback to summary
private final Signal signal

Constructor Detail

InternalMiscHandlerback to summary
private InternalMiscHandler(Signal signal, SignalHandler handler)

Method Detail

handleback to summary
public void handle(Signal ignore)

Implements jdk.internal.misc.Signal.Handler.handle.

Doc from jdk.internal.misc.Signal.Handler.handle.

Handle the given signal

Annotations
@Override
ofback to summary
pack-priv static Signal.Handler of(Signal signal, SignalHandler handler)
sun.misc back to summary

pack-priv final Class Signal.SunMiscHandler

extends Object
implements SignalHandler
Class Inheritance
All Implemented Interfaces
sun.misc.SignalHandler

Field Summary

Modifier and TypeField and Description
private final Signal.Handler
private final Signal

Constructor Summary

AccessConstructor and Description
pack-priv
SunMiscHandler(Signal iSignal, Signal.Handler iHandler)

Method Summary

Modifier and TypeMethod and Description
public void
handle(Signal sig)

Implements sun.misc.SignalHandler.handle.

Handle the given signal

pack-priv static SignalHandler
of(Signal signal, Signal.Handler handler)

public String
toString()

Overrides java.lang.Object.toString.

Returns a string representation of the object.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAllwaitwaitwait

Field Detail

iHandlerback to summary
private final Signal.Handler iHandler
iSignalback to summary
private final Signal iSignal

Constructor Detail

SunMiscHandlerback to summary
pack-priv SunMiscHandler(Signal iSignal, Signal.Handler iHandler)

Method Detail

handleback to summary
public void handle(Signal sig)

Implements sun.misc.SignalHandler.handle.

Doc from sun.misc.SignalHandler.handle.

Handle the given signal

Annotations
@Override
ofback to summary
pack-priv static SignalHandler of(Signal signal, Signal.Handler handler)
toStringback to summary
public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.