Skip to content
Browse files

allow requests to catch signals (such as SIGTERM) in server mode

Use a dedicated thread to receive and handle certain signals (particularly ones that terminates the process) in a synchronous way.
CLI mode has been running with this mechanism.  This diff extends it to the server mode.
When a signal is received by the server process, it will broadcast SIGTERM (instead of the original signal) to all ongoing requests.  If a request registers a handler, it gets a chance to run cleanup code.
Beware that if the request doesn't finish cleanup within the shutdown grace period, the process will exit abruptly anyway.  So there isn't a real guarantee that the cleanup will happen, unless we have very big grace period.

With this mechanism, we also unify the server shutdown process: `HttpServer::stopOnSignal()` sends the signal to the handler thread, which calls `HttpServer::stop()`.

Reviewed By: markw65

Differential Revision: D13925122

fbshipit-source-id: 73bfa62703b5910ac57ad9e35bf6a472f2d2d27e
  • Loading branch information...
binliu19 authored and hhvm-bot committed Feb 2, 2019
1 parent 4aa668c commit aa310fa33287c6268a033bb64d5e5c6a3031b948
@@ -493,7 +493,6 @@ int64_t RuntimeOption::ImageMemoryMaxBytes = 0;
int RuntimeOption::ServerGracefulShutdownWait = 0;
bool RuntimeOption::ServerHarshShutdown = true;
bool RuntimeOption::ServerEvilShutdown = true;
bool RuntimeOption::ServerKillOnSIGTERM = false;
bool RuntimeOption::ServerKillOnTimeout = true;
int RuntimeOption::ServerPreShutdownWait = 0;
int RuntimeOption::ServerShutdownListenWait = 0;
@@ -1947,8 +1946,6 @@ void RuntimeOption::Load(
config, "Server.GracefulShutdownWait", 0);
Config::Bind(ServerHarshShutdown, ini, config, "Server.HarshShutdown",
Config::Bind(ServerKillOnSIGTERM, ini, config, "Server.KillOnSIGTERM",
Config::Bind(ServerKillOnTimeout, ini, config, "Server.KillOnTimeout",
Config::Bind(ServerEvilShutdown, ini, config, "Server.EvilShutdown", true);
@@ -274,7 +274,6 @@ struct RuntimeOption {
static int ServerGracefulShutdownWait;
static bool ServerHarshShutdown;
static bool ServerEvilShutdown;
static bool ServerKillOnSIGTERM;
static bool ServerKillOnTimeout;
static int ServerPreShutdownWait;
static int ServerShutdownListenWait;
@@ -43,6 +43,7 @@
#include "hphp/util/ssl-init.h"
#include "hphp/util/stack-trace.h"
#include "hphp/util/struct-log.h"
#include "hphp/util/sync-signal.h"

#include <folly/Conv.h>
#include <folly/Format.h>
@@ -65,28 +66,47 @@ std::shared_ptr<HttpServer> HttpServer::Server;
time_t HttpServer::StartTime;
std::atomic<double> HttpServer::LoadFactor{1.0};
std::atomic_int HttpServer::QueueDiscount{0};
std::atomic_int HttpServer::SignalReceived{0};
std::atomic_int_fast64_t HttpServer::PrepareToStopTime{0};
time_t HttpServer::OldServerStopTime;
std::vector<ShutdownStat> HttpServer::ShutdownStats;
folly::MicroSpinLock HttpServer::StatsLock;

static void on_kill(int sig) {
signal(sig, SIG_DFL);
// There is a small race condition here with HttpServer::reset in
// program-functions.cpp, but it can only happen if we get a signal while
// shutting down. The fix is to add a lock to HttpServer::Server but it seems
// like overkill.
// signals upon which the server shuts down gracefully
static const int kTermSignals[] = { SIGHUP, SIGINT, SIGTERM, SIGUSR1 };

static void on_kill_server(int sig) { // runs in signal handler thread.
static std::atomic_flag flag = ATOMIC_FLAG_INIT;
if (flag.test_and_set()) return; // it was already called once.

if (HttpServer::Server) {
// Stop handling signals, because the
// server is already shutting down, and we don't want to use the default
// handlers which may immediately terminate the process.

int zero = 0;
HttpServer::SignalReceived.compare_exchange_strong(zero, sig);
// SignalReceived may possibly be set in HttpServer::stopOnSignal().
} else {
raise(sig); // invoke default handler
pthread_exit(nullptr); // terminate signal handler thread

static void exit_on_timeout(int sig) {
// Must only call async-signal-safe functions.
kill(getpid(), SIGKILL);
// we really shouldn't get here, but who knows.
// abort so we catch it as a crash.


: m_stopped(false), m_killed(false), m_stopReason(nullptr) {
HttpServer::HttpServer() {
LoadFactor = RuntimeOption::EvalInitialLoadFactor;

// enabling mutex profiling, but it's not turned on
@@ -139,7 +159,6 @@ HttpServer::HttpServer()

ServerOptions admin_options(RuntimeOption::AdminServerIP,
@@ -176,10 +195,9 @@ HttpServer::HttpServer()

signal(SIGHUP, on_kill);
signal(SIGINT, on_kill);
signal(SIGTERM, on_kill);
signal(SIGUSR1, on_kill);
for (auto const sig : kTermSignals) {
sync_signal(sig, on_kill_server);

// Synchronously stop satellites
@@ -312,6 +330,8 @@ void HttpServer::runOrExitProcess() {


if (RuntimeOption::ServerPort) {
if (!startServer(true)) {
startupFailure("Unable to start page server");
@@ -416,11 +436,8 @@ void HttpServer::runOrExitProcess() {
if (m_stopReason) {
Logger::Warning("Server stopping with reason: %s", m_stopReason);
// if we were killed, bail out immediately
if (m_killed) {
Logger::Info("page server killed");
} else if (auto signo = SignalReceived.load(std::memory_order_acquire)) {
Logger::Warning("Server stopping with reason: %s", strsignal(signo));

@@ -446,20 +463,16 @@ void HttpServer::waitForServers() {
// all other servers invoke waitForEnd on stop

static void exit_on_timeout(int sig) {
signal(sig, SIG_DFL);
#ifdef _WIN32
TerminateProcess(GetCurrentProcess(), (UINT)-1);
kill(getpid(), SIGKILL);
// we really shouldn't get here, but who knows.
// abort so we catch it as a crash.

void HttpServer::stop(const char* stopReason) {
if ( return;

// Let all worker threads know that the server is shutting down. If some
// request installed a PHP-level signal handler through `pcntl_signal(SIGTERM,
// handler_func)`, `handler_func()` will run in the corresponding request
// context, to perform cleanup tasks. If no handler is registered, it is
// ignored.

// we're shutting down flush http logs
@@ -475,13 +488,10 @@ void HttpServer::stop(const char* stopReason) {
if (totalWait > 0) {
// Use a killer thread to _Exit() after totalWait seconds. If
// the main thread returns before that, the killer thread will
// exit. So don't do join() on this thread. Since we create a
// thread here, `HttpServer::stop()` cannot be called in signal
// handlers, use `stopOnSignal()` (which uses SIGALRM) in that
// case.
// exit. So don't do join() on this thread.
auto killer = std::thread([totalWait] {
#ifdef __linux__
sched_param param;
sched_param param{};
param.sched_priority = 5;
pthread_setschedparam(pthread_self(), SCHED_RR, &param);
// It is OK if we fail to increase thread priority.
@@ -501,36 +511,27 @@ void HttpServer::stop(const char* stopReason) {

void HttpServer::stopOnSignal(int sig) {
if ( return;
// we're shutting down flush http logs

// Signal to the main server thread to exit immediately if
// we want to die on SIGTERM
if (RuntimeOption::ServerKillOnSIGTERM && sig == SIGTERM) {
Lock lock(this);
m_stopped = true;
m_killed = true;
m_stopReason = "SIGTERM received";
int zero = 0;
if (SignalReceived.compare_exchange_strong(zero, sig) &&
RuntimeOption::ServerKillOnTimeout) {
auto const totalWait =
RuntimeOption::ServerPreShutdownWait +
RuntimeOption::ServerShutdownListenWait +
// In case HttpServer::stop() isn't invoked in the synchronous signal
// handler.
if (totalWait > 0) {
signal(SIGALRM, exit_on_timeout);
sigset_t s;
sigaddset(&s, SIGALRM);
pthread_sigmask(SIG_UNBLOCK, &s, nullptr);

if (RuntimeOption::ServerGracefulShutdownWait) {
signal(SIGALRM, exit_on_timeout);

Lock lock(this);
m_stopped = true;
m_stopReason = "signal received";
// Invoke HttpServer::stop() from the synchronous signal handler thread. This
// way, stopOnSignal() is asynchronous-signal safe.

void HttpServer::EvictFileCache() {
@@ -32,18 +32,20 @@ namespace HPHP {

struct HttpServer : Synchronizable, TakeoverListener,
Server::ServerEventListener {
static std::shared_ptr<HttpServer> Server;
static time_t StartTime;
static std::atomic<double> LoadFactor;
static std::atomic_int QueueDiscount;
static std::atomic_int SignalReceived;

static std::atomic_int_fast64_t PrepareToStopTime;
static time_t OldServerStopTime;
static std::vector<ShutdownStat> ShutdownStats;
static folly::MicroSpinLock StatsLock; // for ShutdownStats

explicit HttpServer();
~HttpServer() override;

@@ -134,9 +136,8 @@ struct HttpServer : Synchronizable, TakeoverListener,

std::atomic<bool> m_stopping{false};
bool m_stopped;
bool m_killed;
const char* m_stopReason;
bool m_stopped{false};
const char* m_stopReason{nullptr};

ServerPtr m_pageServer;
ServerPtr m_adminServer;
@@ -163,12 +163,19 @@ bool is_sync_signal(int signo) {

void reset_sync_signals() {
for (auto iter : g_sync_handlers) {
for (auto const iter : g_sync_handlers) {
signal(iter.first, SIG_DFL);
pthread_sigmask(SIG_UNBLOCK, &g_sync_signals, nullptr);

void ignore_sync_signals() {
for (auto const iter : g_sync_handlers) {
signal(iter.first, SIG_IGN);
pthread_sigmask(SIG_UNBLOCK, &g_sync_signals, nullptr);

void block_sync_signals_and_start_handler_thread() {
if (g_sync_handlers.empty()) return;
@@ -36,6 +36,10 @@ void block_sync_signals_and_start_handler_thread();
// in the thread.
void reset_sync_signals();

// Unblock sync signals and ignore them (instead of handing them with the
// default hander).
void ignore_sync_signals();

// Whether a signal is intended to be forwarded to PHP code.
bool is_sync_signal(int signo);

0 comments on commit aa310fa

Please sign in to comment.
You can’t perform that action at this time.