PHP Manual: ssh2_send

Description

function ssh2_send_signal(resource $channel, string $signal): bool

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

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

Parameters

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.

Return Values

Returns true on success or false on failure.

Errors/Exceptions

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

Examples

Example #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_send_signal

Description

Parameters

Return Values

Errors/Exceptions

Examples

See Also