libssh2_channel_process_stlibsshl2ibssh2_channel_process_startup(3)


NAME
       libssh2_channel_process_startup - request a shell on a channel

SYNOPSIS
       #include <libssh2.h>

       int   libssh2_channel_process_startup(LIBSSH2_CHANNEL  *channel,  const
       char *request, unsigned int request_len, const char *message,  unsigned
       int message_len);

       int libssh2_channel_shell(LIBSSH2_CHANNEL *channel);

       int  libssh2_channel_exec(LIBSSH2_CHANNEL  *channel,  const  char *mes-
       sage);

       int  libssh2_channel_subsystem(LIBSSH2_CHANNEL  *channel,  const   char
       *message);


DESCRIPTION
       channel - Active session channel instance.

       request  -  Type  of  process  to  startup. The SSH2 protocol currently
       defines shell, exec, and subsystem as standard process services.

       request_len - Length of request parameter.

       message - Request specific message data to include.

       message_len - Length of message parameter.

       Initiate a request on a session type channel such as returned  by  lib-
       ssh2_channel_open_ex(3)

RETURN VALUE
       Return   0  on  success  or  negative  on  failure.   It  returns  LIB-
       SSH2_ERROR_EAGAIN  when  it   would   otherwise   block.   While   LIB-
       SSH2_ERROR_EAGAIN  is  a negative number, it isn't really a failure per
       se.

ERRORS
       LIBSSH2_ERROR_ALLOC -  An internal memory allocation call failed.

       LIBSSH2_ERROR_SOCKET_SEND - Unable to send data on socket.

       LIBSSH2_ERROR_CHANNEL_REQUEST_DENIED -

SEE ALSO
       libssh2_channel_open_ex(3)








libssh2 0.15                1 Jun 2007                          1