SysTutorials Posts

NAME libssh2_channel_forward_listen_ex – 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 –…

NAME libssh2_channel_forward_listen – convenience macro for libssh2_channel_forward_listen_ex(3) calls SYNOPSIS #include <libssh2.h> int libssh2_channel_forward_listen(LIBSSH2_SESSION *session, int port); DESCRIPTION This is a macro defined in a public libssh2 header file that is using the underlying function libssh2_channel_forward_listen_ex(3). RETURN VALUE See libssh2_channel_forward_listen_ex(3) ERRORS See libssh2_channel_forward_listen_ex(3) SEE ALSO libssh2_channel_forward_listen_ex(3) Index

NAME libssh2_channel_forward_cancel – cancel a forwarded TCP port SYNOPSIS #include <libssh2.h> int libssh2_channel_forward_cancel(LIBSSH2_LISTENER *listener); DESCRIPTION listener – Forwarding listener instance as returned by libssh2_channel_forward_listen_ex(3) Instruct the remote host to stop listening for new connections on a previously requested host/port. RETURN VALUE Return 0 on success or negative on failure. It returns LIBSSH2_ERROR_EAGAIN when it would…

NAME libssh2_channel_forward_accept – accept a queued connection SYNOPSIS #include <libssh2.h> LIBSSH2_CHANNEL * libssh2_channel_forward_accept(LIBSSH2_LISTENER *listener); DESCRIPTION listener is a forwarding listener instance as returned by libssh2_channel_forward_listen_ex(3). RETURN VALUE A newly allocated channel instance or NULL on failure. ERRORS When this function returns NULL use libssh2_session_last_errno(3) to extract the error code. If that code is LIBSSH2_ERROR_EAGAIN, the…

NAME libssh2_channel_flush_stderr – convenience macro for libssh2_channel_flush_ex(3) calls SYNOPSIS #include <libssh2.h> int libssh2_channel_flush_stderr(LIBSSH2_CHANNEL *channel); DESCRIPTION This is a macro defined in a public libssh2 header file that is using the underlying function libssh2_channel_flush_ex(3). RETURN VALUE See libssh2_channel_flush_ex(3) ERRORS See libssh2_channel_flush_ex(3) SEE ALSO libssh2_channel_flush_ex(3) Index

NAME libssh2_channel_flush_ex – flush a channel SYNOPSIS #include <libssh2.h> int libssh2_channel_flush_ex(LIBSSH2_CHANNEL *channel, int streamid); int libssh2_channel_flush(LIBSSH2_CHANNEL *channel); int libssh2_channel_flush_stderr(LIBSSH2_CHANNEL *channel); DESCRIPTION channel – Active channel stream to flush. streamid – Specific substream number to flush. Groups of substreams may be flushed by passing on of the following Constants. LIBSSH2_CHANNEL_FLUSH_EXTENDED_DATA: Flush all extended data substreams LIBSSH2_CHANNEL_FLUSH_ALL:…

NAME libssh2_channel_flush – convenience macro for libssh2_channel_flush_ex(3) calls SYNOPSIS #include <libssh2.h> int libssh2_channel_flush(LIBSSH2_CHANNEL *channel); DESCRIPTION This is a macro defined in a public libssh2 header file that is using the underlying function libssh2_channel_flush_ex(3). RETURN VALUE See libssh2_channel_flush_ex(3) ERRORS See libssh2_channel_flush_ex(3) SEE ALSO libssh2_channel_flush_ex(3) Index

NAME libssh2_channel_exec – convenience macro for libssh2_channel_process_startup(3) calls SYNOPSIS #include <libssh2.h> int libssh2_channel_exec(LIBSSH2_CHANNEL *channel, const char *command); DESCRIPTION This is a macro defined in a public libssh2 header file that is using the underlying function libssh2_channel_process_startup(3). RETURN VALUE See libssh2_channel_process_startup(3) ERRORS See libssh2_channel_process_startup(3) SEE ALSO libssh2_channel_process_startup(3) Index

NAME libssh2_channel_eof – check a channel’s EOF status SYNOPSIS #include <libssh2.h> int libssh2_channel_eof(LIBSSH2_CHANNEL *channel); DESCRIPTION channel – active channel stream to set closed status on. Check if the remote host has sent an EOF status for the selected stream. RETURN VALUE Returns 1 if the remote host has sent EOF, otherwise 0. Negative on failure….

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…

NAME libssh2_channel_direct_tcpip – convenience macro for libssh2_channel_direct_tcpip_ex(3) calls SYNOPSIS #include <libssh2.h> LIBSSH2_CHANNEL * libssh2_channel_direct_tcpip(LIBSSH2_SESSION *session, const char *host, int port); DESCRIPTION This is a macro defined in a public libssh2 header file that is using the underlying function libssh2_channel_direct_tcpip_ex(3). RETURN VALUE See libssh2_channel_direct_tcpip_ex(3) ERRORS See libssh2_channel_direct_tcpip_ex(3) SEE ALSO libssh2_channel_direct_tcpip_ex(3) Index

NAME libssh2_channel_close – close a channel SYNOPSIS #include <libssh2.h> int libssh2_channel_close(LIBSSH2_CHANNEL *channel); DESCRIPTION channel – active channel stream to set closed status on. Close an active data channel. In practice this means sending an SSH_MSG_CLOSE packet to the remote host which serves as instruction that no further data will be sent to it. The remote…

NAME libssh2_base64_decode – decode a base64 encoded string SYNOPSIS #include <libssh2.h> int libssh2_base64_decode(LIBSSH2_SESSION *session, char **dest,                     unsigned int *dest_len, const char *src,                     unsigned int src_len); DESCRIPTION This function is deemed DEPRECATED and will be removed from libssh2 in a future version. Don’t use it! Decode a base64 chunk and store it into a newly allocated buffer. ‘dest_len’…

NAME libssh2_banner_set – set the SSH prococol banner for the local client SYNOPSIS #include <libssh2.h> int libssh2_banner_set(LIBSSH2_SESSION *session, const char *banner); DESCRIPTION This function is DEPRECATED. Use libssh2_session_banner_set(3) instead! session – Session instance as returned by libssh2_session_init_ex(3) banner – A pointer to a user defined banner Set the banner that will be sent to the…

NAME libssh2_agent_userauth – authenticate a session with a public key, with the help of ssh-agent SYNOPSIS #include <libssh2.h> int libssh2_agent_userauth(LIBSSH2_AGENT *agent,                      const char *username,                      struct libssh2_agent_publickey *identity); DESCRIPTION agent – ssh-agent handle as returned by libssh2_agent_init(3) username – Remote user name to authenticate as. identity – Public key to authenticate with, as returned by libssh2_agent_get_identity(3) Attempt public…

NAME libssh2_agent_list_identities – request an ssh-agent to list of public keys. SYNOPSIS #include <libssh2.h> int libssh2_agent_list_identities(LIBSSH2_AGENT *agent); DESCRIPTION Request an ssh-agent to list of public keys, and stores them in the internal collection of the handle. Call libssh2_agent_get_identity(3) to get a public key off the collection. RETURN VALUE Returns 0 if succeeded, or a negative…

NAME libssh2_agent_init – init an ssh-agent handle SYNOPSIS #include <libssh2.h> LIBSSH2_AGENT *libssh2_agent_init(LIBSSH2_SESSION *session); DESCRIPTION Init an ssh-agent handle. Returns the handle to an internal representation of an ssh-agent connection. After the successful initialization, an application can call libssh2_agent_connect(3) to connect to a running ssh-agent. Call libssh2_agent_free(3) to free the handle again after you’re doing using…

NAME libssh2_agent_get_identity – get a public key off the collection of public keys managed by ssh-agent SYNOPSIS #include <libssh2.h> int libssh2_agent_get_identity(LIBSSH2_AGENT *agent,                          struct libssh2_agent_publickey **store,                          struct libssh2_agent_publickey *prev); DESCRIPTION libssh2_agent_get_identity(3) allows an application to iterate over all public keys in the collection managed by ssh-agent. store should point to a pointer that gets filled in to point…

NAME libssh2_agent_free – free an ssh-agent handle SYNOPSIS #include <libssh2.h> void libssh2_agent_free(LIBSSH2_AGENT *agent); DESCRIPTION Free an ssh-agent handle. This function also frees the internal collection of public keys. RETURN VALUE None. AVAILABILITY Added in libssh2 1.2 SEE ALSO libssh2_agent_init(3) libssh2_agent_disconnect(3) Index

NAME libssh2_agent_disconnect – close a connection to an ssh-agent SYNOPSIS #include <libssh2.h> int libssh2_agent_disconnect(LIBSSH2_AGENT *agent); DESCRIPTION Close a connection to an ssh-agent. RETURN VALUE Returns 0 if succeeded, or a negative value for error. AVAILABILITY Added in libssh2 1.2 SEE ALSO libssh2_agent_connect(3) libssh2_agent_free(3) Index