Skip to content

HADOOP-19329. Remove direct usage of sun.misc.Signal #7759

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Jul 12, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -21,10 +21,9 @@
import java.util.concurrent.atomic.AtomicInteger;

import org.apache.hadoop.util.Preconditions;
import org.apache.hadoop.util.SignalUtil;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import sun.misc.Signal;
import sun.misc.SignalHandler;

import org.apache.hadoop.classification.InterfaceAudience;
import org.apache.hadoop.classification.InterfaceStability;
Expand All @@ -38,8 +37,7 @@
*/
@InterfaceAudience.Private
@InterfaceStability.Unstable
@SuppressWarnings("UseOfSunClasses")
public final class IrqHandler implements SignalHandler {
public final class IrqHandler implements SignalUtil.Handler {
private static final Logger LOG = LoggerFactory.getLogger(IrqHandler.class);

/**
Expand Down Expand Up @@ -68,7 +66,7 @@ public final class IrqHandler implements SignalHandler {
/**
* Stored signal.
*/
private Signal signal;
private SignalUtil.Signal signal;

/**
* Create an IRQ handler bound to the specific interrupt.
Expand All @@ -89,8 +87,8 @@ public IrqHandler(String name, Interrupted handler) {
public void bind() {
Preconditions.checkState(signal == null, "Handler already bound");
try {
signal = new Signal(name);
Signal.handle(signal, this);
signal = new SignalUtil.Signal(name);
SignalUtil.handle(signal, this);
} catch (IllegalArgumentException e) {
throw new IllegalArgumentException(
"Could not set handler for signal \"" + name + "\"."
Expand All @@ -110,7 +108,7 @@ public String getName() {
* Raise the signal.
*/
public void raise() {
Signal.raise(signal);
SignalUtil.raise(signal);
}

@Override
Expand All @@ -123,7 +121,7 @@ public String toString() {
* @param s signal raised
*/
@Override
public void handle(Signal s) {
public void handle(SignalUtil.Signal s) {
signalCount.incrementAndGet();
InterruptData data = new InterruptData(s.getName(), s.getNumber());
LOG.info("Interrupted: {}", data);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,6 @@
package org.apache.hadoop.util;

import org.slf4j.Logger;
import sun.misc.Signal;
import sun.misc.SignalHandler;

import org.apache.hadoop.classification.InterfaceAudience;
import org.apache.hadoop.classification.InterfaceStability;
Expand All @@ -41,13 +39,13 @@ public enum SignalLogger {
/**
* Our signal handler.
*/
private static class Handler implements SignalHandler {
private static class Handler implements SignalUtil.Handler {
final private Logger log;
final private SignalHandler prevHandler;
final private SignalUtil.Handler prevHandler;

Handler(String name, Logger log) {
this.log = log;
prevHandler = Signal.handle(new Signal(name), this);
prevHandler = SignalUtil.handle(new SignalUtil.Signal(name), this);
}

/**
Expand All @@ -56,9 +54,8 @@ private static class Handler implements SignalHandler {
* @param signal The incoming signal
*/
@Override
public void handle(Signal signal) {
log.error("RECEIVED SIGNAL " + signal.getNumber() +
": SIG" + signal.getName());
public void handle(SignalUtil.Signal signal) {
log.error("RECEIVED SIGNAL {}: SIG{}", signal.getNumber(), signal.getName());
prevHandler.handle(signal);
}
}
Expand All @@ -75,7 +72,7 @@ public void register(final Logger log) {
registered = true;
StringBuilder bld = new StringBuilder();
bld.append("registered UNIX signal handlers for [");
final String SIGNALS[] = { "TERM", "HUP", "INT" };
final String[] SIGNALS = {"TERM", "HUP", "INT"};
String separator = "";
for (String signalName : SIGNALS) {
try {
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,168 @@
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

package org.apache.hadoop.util;

import org.apache.hadoop.classification.InterfaceAudience;

import org.apache.hadoop.util.dynamic.BindingUtils;
import org.apache.hadoop.util.dynamic.DynConstructors;
import org.apache.hadoop.util.dynamic.DynMethods;

import java.lang.reflect.Method;
import java.lang.reflect.Proxy;

@InterfaceAudience.Private
public class SignalUtil {

static final Class<?> JDK_SIGNAL_CLAZZ =
BindingUtils.loadClassSafely("sun.misc.Signal");
static final Class<?> JDK_SIGNAL_HANDLER_CLAZZ =
BindingUtils.loadClassSafely("sun.misc.SignalHandler");

static final DynConstructors.Ctor<?> JDK_SIGNAL_CTOR =
new DynConstructors.Builder()
.impl(JDK_SIGNAL_CLAZZ, String.class)
.build();

static final DynMethods.StaticMethod JDK_SIGNAL_HANDLE_STATIC_METHOD =
new DynMethods.Builder("handle")
.impl(JDK_SIGNAL_CLAZZ, JDK_SIGNAL_CLAZZ, JDK_SIGNAL_HANDLER_CLAZZ)
.buildStatic();

static final DynMethods.StaticMethod JDK_SIGNAL_RAISE_STATIC_METHOD =
new DynMethods.Builder("raise")
.impl(JDK_SIGNAL_CLAZZ, JDK_SIGNAL_CLAZZ)
.buildStatic();

static final DynMethods.UnboundMethod JDK_SIGNAL_HANDLER_HANDLE_UNBOUND_METHOD =
new DynMethods.Builder("handle")
.impl(JDK_SIGNAL_HANDLER_CLAZZ, JDK_SIGNAL_CLAZZ)
.build();

@InterfaceAudience.Private
public static class Signal {
private static final DynMethods.UnboundMethod GET_NUMBER_UNBOUND_METHOD =
new DynMethods.Builder("getNumber").impl(JDK_SIGNAL_CLAZZ).build();

private static final DynMethods.UnboundMethod GET_NAME_UNBOUND_METHOD =
new DynMethods.Builder("getName").impl(JDK_SIGNAL_CLAZZ).build();

private final Object/* sun.misc.Signal */ delegate;
private final DynMethods.BoundMethod getNumberMethod;
private final DynMethods.BoundMethod getNameMethod;

public Signal(String name) {
Preconditions.checkNotNull(name);
this.delegate = JDK_SIGNAL_CTOR.newInstance(name);
this.getNumberMethod = GET_NUMBER_UNBOUND_METHOD.bind(delegate);
this.getNameMethod = GET_NAME_UNBOUND_METHOD.bind(delegate);
}

public Signal(Object delegate) {
Preconditions.checkArgument(JDK_SIGNAL_CLAZZ.isInstance(delegate),
String.format("Expected class is '%s', but actual class is '%s'",
JDK_SIGNAL_CLAZZ.getName(), delegate.getClass().getName()));
this.delegate = delegate;
this.getNumberMethod = GET_NUMBER_UNBOUND_METHOD.bind(delegate);
this.getNameMethod = GET_NAME_UNBOUND_METHOD.bind(delegate);
}

public int getNumber() {
return getNumberMethod.invoke();
}

public String getName() {
return getNameMethod.invoke();
}

@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (obj instanceof Signal) {
return delegate.equals(((Signal)obj).delegate);
}
return false;
}

@Override
public int hashCode() {
return delegate.hashCode();
}

@Override
public String toString() {
return delegate.toString();
}
}

@InterfaceAudience.Private
public interface Handler {
void handle(Signal sig);
}

static class JdkSignalHandlerImpl implements Handler {

private final Object/* sun.misc.SignalHandler */ delegate;
private final DynMethods.BoundMethod jdkSignalHandlerHandleMethod;

JdkSignalHandlerImpl(Handler handler) {
this.delegate = Proxy.newProxyInstance(
getClass().getClassLoader(),
new Class<?>[] {JDK_SIGNAL_HANDLER_CLAZZ},
(proxyObj, method, args) -> {
if ("handle".equals(method.getName()) && args.length == 1
&& JDK_SIGNAL_CLAZZ.isInstance(args[0])) {
handler.handle(new Signal(args[0]));
return null;
} else {
Method delegateMethod = handler.getClass().getMethod(
method.getName(), method.getParameterTypes());
return delegateMethod.invoke(handler, args);
}
}
);
this.jdkSignalHandlerHandleMethod = JDK_SIGNAL_HANDLER_HANDLE_UNBOUND_METHOD.bind(delegate);
}

JdkSignalHandlerImpl(Object delegate) {
Preconditions.checkArgument(JDK_SIGNAL_HANDLER_CLAZZ.isInstance(delegate),
String.format("Expected class is '%s', but actual class is '%s'",
JDK_SIGNAL_HANDLER_CLAZZ.getName(), delegate.getClass().getName()));
this.delegate = delegate;
this.jdkSignalHandlerHandleMethod = JDK_SIGNAL_HANDLER_HANDLE_UNBOUND_METHOD.bind(delegate);
}

@Override
public void handle(Signal sig) {
jdkSignalHandlerHandleMethod.invoke(sig.delegate);
}
}

public static Handler handle(Signal sig, Handler handler) {
Object preHandle = JDK_SIGNAL_HANDLE_STATIC_METHOD.invoke(
sig.delegate, new JdkSignalHandlerImpl(handler).delegate);
return new JdkSignalHandlerImpl(preHandle);
}

public static void raise(Signal sig) throws IllegalArgumentException {
JDK_SIGNAL_RAISE_STATIC_METHOD.invoke(sig.delegate);
}
}