Watch designated servers and take action if they don't handle an unblock pulse
server-monitor [-fv] max_unblock_time [server_ident server_action]*
QNX Neutrino
Actions specified for an executable name apply to all processes with that name. You should specify a name if the server is likely to be terminated and restarted in the normal operation of your system.
If you specify a delay, server-monitor waits the specified number of milliseconds before moving to the next action in the list; otherwise it waits for 100 ms.
The server-monitor provides a way to detect servers that don't respond to unblock pulses.
If a server sets the _NTO_CHF_UNBLOCK flag when it calls ChannelCreate(), then the process manager delivers an unblock pulse when a thread that's REPLY-blocked on the channel attempts to unblock before the server replies to its message. Servers must respond to these unblock pulses, or else the clients can be blocked forever.
The server-monitor watches a list of servers and takes the specified actions if a server doesn't handle unblock pulses in a certain time.
When server-monitor starts, it registers itself with the process manager. In order to do this, server-monitor needs to have the PROCMGR_AID_SERVER_MONITOR ability enabled (see procmgr_ability() in the C Library Reference). There can be only one instance of server-monitor running at any time.
When a client requests an unblock, the kernel sends an unblock pulse to the server that the client is blocked on. If server-monitor is running, and the server doesn't unblock the client within max_unblock_time milliseconds, then the kernel sends a pulse to server-monitor. When server-monitor receives this pulse, it checks to see if the server's process ID is in its list, or if a pattern in the list matches the server's process executable name:
If you want to determine whether server-monitor is running, you can send a _PROC_SERVMON message with a subtype of _PROC_SERVER_MONITOR_ALIVE to the process manager. For example:
int is_server_monitor_running (const pid_t pid)
{
proc_servmon_t msg = { 0 };
int ret;
msg.i.type = _PROC_SERVMON;
msg.i.subtype = _PROC_SERVER_MONITOR_ALIVE;
ret = MsgSendnc(PROCMGR_COID, &msg.i, sizeof(msg.i), NULL, 0);
return ret;
}
The result is EOK if server-monitor is running, or ESRCH if it isn't.
Start server-monitor with a max_unblock_time of 500 ms, and a list of actions for process ID 123456:
server-monitor 500 123456 SIGTERM:300,SIGKILL,reboot
In this case, when server-monitor gets a pulse indicating that the server with the process ID 123456 has failed to unblock a client, it sends the server a SIGTERM signal. If the client thread is still blocked after a delay of 300 ms, server-monitor sends the server a SIGKILL signal. If the client thread is still blocked after a further delay of 100 ms (the default), server-monitor reboots the system.
Start server-monitor with a max_unblock_time of 500 ms, and a list of actions for all processes with the name io-audio:
server-monitor 500 io-audio SIGTERM:300,SIGKILL,reboot
If io-audio will be terminated and restarted during normal target system operation, you should use the process name because io-audio will have a new process ID every time it's restarted.