libssh2_channel_direct_tcpip_ex(3)

libssh2_channel_direct_tcpip_ex(3libssh2 manualibssh2_channel_direct_tcpip_ex(3)

NAME

     libssh2_channel_direct_tcpip_ex - Tunnel  a  TCP  connection
     through an SSH session

SYNOPSIS

     #include <libssh2.h>

     LIBSSH2_CHANNEL                                            *
     libssh2_channel_direct_tcpip_ex(LIBSSH2_SESSION    *session,
     const char *host, int port, const char *shost, int sport);

     LIBSSH2_CHANNEL                                            *
     libssh2_channel_direct_tcpip(LIBSSH2_SESSION *session, const
     char *host, int port);

DESCRIPTION

     session    -    Session    instance    as    returned     by
     libssh2_session_init_ex(3)

     host - Third party host to connect to using the SSH host  as
     a proxy.

     port - Port on third party host to connect to.

     shost - Host to tell the  SSH  server  the  connection  ori-
     ginated on.

     sport - Port to tell the  SSH  server  the  connection  ori-
     ginated from.

     Tunnel a TCP/IP connection through the SSH transport via the
     remote  host to a third party. Communication from the client
     to the SSH server remains encrypted, communication from  the
     server to the 3rd party host travels in cleartext.

RETURN VALUE

     Pointer to a newly allocated  LIBSSH2_CHANNEL  instance,  or
     NULL on errors.

ERRORS

     LIBSSH2_ERROR_ALLOC -  An internal  memory  allocation  call
     failed.

SEE ALSO

     libssh2_session_init_ex(3)

libssh2 0.15         Last change: 1 Jun 2007                    1