ssh2_send_signal

Send a signal to a remote process

説明

bool ssh2_send_signal(resource $channel, string $signal)

Sends a signal to the process running at the remote end of the given channel.

注意: This function is only available when the extension is built against libssh2 >= 1.9.0.

パラメータ

channel
An SSH channel stream, as returned by ssh2_exec or ssh2_shell.
signal
The name of the signal to send, without the SIG prefix, as defined by the SSH connection protocol (» RFC 4254); for example TERM, KILL or INT. The value is forwarded to the server as is; it is not validated against the names listed by the protocol.

戻り値

成功した場合に true を、失敗した場合に false を返します。

エラー / 例外

An E_WARNING is emitted when channel is not an SSH channel stream, and when the signal could not be sent.

例

例1 Interrupting a remote command

<?php
$connection = ssh2_connect('shell.example.com', 22);
ssh2_auth_password($connection, 'username', 'password');

$stream = ssh2_exec($connection, 'trap "echo interrupted" INT; sleep 60');

ssh2_send_signal($stream, 'INT');

stream_set_blocking($stream, true);
echo stream_get_contents($stream);
?>

参考

  • ssh2_exec
  • ssh2_shell
  • ssh2_send_eof