PHP Manual
Prev |  | Next

# ssh2_shell

(PECL)

ssh2_shell -- Request an interactive shell

## Description

resource ssh2_shell ( resource session [, string term_type [, array env [, int width [, int height [, int width_height_type]]]]] )

Open a shell at the remote end and allocate a stream for it. term_type should correspond to one of the entries in the target system's /etc/termcap file and defaults to vanilla. env may be passed as an associative array of name/value pairs to set in the target environment.

width, and height define the width and height of the virtual terminal allocated for the shell process. width_height_type should be one of `SSH2_TERM_UNIT_CHARS` or `SSH2_TERM_UNIT_PIXELS`.

Example 1. Executing a command

`<?php $connection = ssh2_connect('shell.example.com', 22); ssh2_auth_password($connection, 'username', 'password'); $stream = ssh2_shell($connection, 'vt102', null, 80, 24, SSH2_TERM_UNIT_CHARS); ?>`

See Also: ssh2_exec(), ssh2_tunnel(), and ssh2_fetch_stream()

Prev | Home | Next
ssh2_sftp | Up | ssh2_tunnel