libssh2_channel_forward_listen_ex - Man Page

listen to inbound connections

Synopsis

#include <libssh2.h>

LIBSSH2_LISTENER *
libssh2_channel_forward_listen_ex(LIBSSH2_SESSION *session,
                                  char *host, int port,
                                  int *bound_port, int queue_maxsize);

LIBSSH2_LISTENER *
libssh2_channel_forward_listen(LIBSSH2_SESSION *session, int port);

Description

Instruct the remote SSH server to begin listening for inbound TCP/IP connections. New connections will be queued by the library until accepted by libssh2_channel_forward_accept(3).

session - instance as returned by libssh2_session_init().

host - specific address to bind to on the remote host. Binding to 0.0.0.0 (default when NULL is passed) will bind to all available addresses.

port - port to bind to on the remote host. When 0 is passed, the remote host will select the first available dynamic port.

bound_port - Populated with the actual port bound on the remote host. Useful when requesting dynamic port numbers.

queue_maxsize - Maximum number of pending connections to queue before rejecting further attempts.

libssh2_channel_forward_listen(3) is a macro.

Return Value

A newly allocated LIBSSH2_LISTENER instance or NULL on failure.

Errors

LIBSSH2_ERROR_ALLOC - An internal memory allocation call failed.

LIBSSH2_ERROR_SOCKET_SEND - Unable to send data on socket.

LIBSSH2_ERROR_PROTO - An invalid SSH protocol response was received on the socket.

LIBSSH2_ERROR_REQUEST_DENIED - The remote server refused the request.

LIBSSH2_ERROR_EAGAIN - Marked for non-blocking I/O but the call would block.

See Also

libssh2_channel_forward_accept(3)

Referenced By

libssh2_channel_forward_accept(3), libssh2_channel_forward_cancel(3), libssh2_channel_forward_listen(3).

1 Jun 2007 libssh2 0.15