Linux Manuals session 3

libssh2_session_startup – begin transport layer Synopsis#include <libssh2.h> int libssh2_session_startup(LIBSSH2_SESSION *session, int socket); DescriptionStarting in libssh2 version 1.2.8 this function is considered deprecated. Use libssh2_session_handshake(3) instead. session – Session instance as returned by libssh2_session_init_ex(3) socket – Connected socket descriptor. Typically a TCP connection though the protocol allows for any reliable transport and the library will attempt…

libssh2_session_set_timeout – set timeout for blocking functions Synopsis#include <libssh2.h> void libssh2_session_set_timeout(LIBSSH2_SESSION *session, long timeout);DescriptionSet the timeout in milliseconds for how long a blocking the libssh2 function calls may wait until they consider the situation an error and return LIBSSH2_ERROR_TIMEOUT. By default or if you set the timeout to zero, libssh2 has no timeout for blocking…

libssh2_session_set_blocking – set or clear blocking mode on session Synopsis#include <libssh2.h> void libssh2_session_set_blocking(LIBSSH2_SESSION *session, int blocking); Descriptionsession – session instance as returned by libssh2_session_init_ex(3) blocking – Set to a non-zero value to make the channel block, or zero to make it non-blocking. Set or clear blocking mode on the selected on the session. This will…

libssh2_session_methods – return the currently active algorithms Synopsis#include <libssh2.h> const char * libssh2_session_methods(LIBSSH2_SESSION *session, int method_type); Descriptionsession – Session instance as returned by libssh2_session_init_ex(3) method_type – one of the method type constants: LIBSSH2_METHOD_KEX, LIBSSH2_METHOD_HOSTKEY, LIBSSH2_METHOD_CRYPT_CS, LIBSSH2_METHOD_CRYPT_SC, LIBSSH2_METHOD_MAC_CS, LIBSSH2_METHOD_MAC_SC, LIBSSH2_METHOD_COMP_CS, LIBSSH2_METHOD_COMP_SC, LIBSSH2_METHOD_LANG_CS, LIBSSH2_METHOD_LANG_SC. Returns the actual method negotiated for a particular transport parameter. Return ValueNegotiated method…

libssh2_session_method_pref – set preferred key exchange method Synopsis#include <libssh2.h> int libssh2_session_method_pref(LIBSSH2_SESSION *session, int method_type, const char *prefs); Descriptionsession – Session instance as returned by libssh2_session_init_ex(3) method_type – One of the Method Type constants. prefs – Coma delimited list of preferred methods to use with the most preferred listed first and the least preferred listed last….

libssh2_session_last_error – get the most recent error Synopsis#include <libssh2.h> int libssh2_session_last_error(LIBSSH2_SESSION *session, char **errmsg, int *errmsg_len, int want_buf); Descriptionsession – Session instance as returned by libssh2_session_init_ex(3) errmsg – If not NULL, is populated by reference with the human readable form of the most recent error message. errmsg_len – If not NULL, is populated by reference…

libssh2_session_last_errno – get the most recent error number Synopsis#include <libssh2.h> int libssh2_session_last_errno(LIBSSH2_SESSION *session); Descriptionsession – Session instance as returned by libssh2_session_init_ex(3) Determine the most recent error condition. Return ValueNumeric error code corresponding to the the Error Code constants. See Alsolibssh2_session_last_error(3)

libssh2_session_init_ex – initializes an SSH session object Synopsis#include <libssh2.h> LIBSSH2_SESSION * libssh2_session_init_ex(LIBSSH2_ALLOC_FUNC((*myalloc)), LIBSSH2_FREE_FUNC((*myfree)), LIBSSH2_REALLOC_FUNC((*myrealloc)), void *abstract); LIBSSH2_SESSION * libssh2_session_init(void); Descriptionmyalloc – Custom allocator function. Refer to the section on Callbacks for implementing an allocator callback. Pass a value of NULL to use the default system allocator. myfree – Custom de-allocator function. Refer to the section…

libssh2_session_init – convenience macro for libssh2_session_init_ex(3) calls Synopsis#include <libssh2.h> LIBSSH2_SESSION * libssh2_session_init(void); DescriptionThis is a macro defined in a public libssh2 header file that is using the underlying function libssh2_session_init_ex(3). Return ValueSee libssh2_session_init_ex(3) ErrorsSee libssh2_session_init_ex(3) See Alsolibssh2_session_init_ex(3)

libssh2_session_hostkey – get the remote key Synopsis#include <libssh2.h> const char *libssh2_session_hostkey(LIBSSH2_SESSION *session,                               size_t *len, int *type); DescriptionReturns a pointer to the current host key, the value len points to will get the length of the key. The value type points to the type of hostkey which is one of: LIBSSH2_HOSTKEY_TYPE_RSA, LIBSSH2_HOSTKEY_TYPE_DSS, or LIBSSH2_HOSTKEY_TYPE_UNKNOWN. Return ValueA pointer, or…

libssh2_session_get_timeout – get the timeout for blocking functions Synopsis#include <libssh2.h> long libssh2_session_get_timeout(LIBSSH2_SESSION *session);DescriptionReturns the timeout (in milliseconds) for how long a blocking the libssh2 function calls may wait until they consider the situation an error and return LIBSSH2_ERROR_TIMEOUT. By default libssh2 has no timeout (zero) for blocking functions. Return ValueThe value of the timeout setting….

libssh2_session_get_blocking – TODO Synopsisint libssh2_session_get_blocking(LIBSSH2_SESSION *session); DescriptionReturns 0 if the state of the session has previously be set to non-blocking and it returns 1 if the state was set to blocking. Return ValueSee description. See Alsolibssh2_session_set_blocking(3)

libssh2_session_free – frees resources associated with a session instance Synopsis#include <libssh2.h> int libssh2_session_free(LIBSSH2_SESSION *session); DescriptionFrees all resources associated with a session instance. Typically called after libssh2_session_disconnect_ex(3) Return ValueReturn 0 on success or negative on failure. It returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative number, it isn’t really a failure per…

libssh2_session_flag – TODO Synopsisint libssh2_session_flag(LIBSSH2_SESSION *session, int flag, int value); DescriptionSet options for the created session. flag is the option to set, while value is typically set to 1 or 0 to enable or disable the option. FlagsLIBSSH2_FLAG_SIGPIPE If set, libssh2 will not attempt to block SIGPIPEs but will let them trigger from the underlying…

libssh2_session_disconnect_ex – terminate transport layer Synopsis#include <libssh2.h> int libssh2_session_disconnect_ex(LIBSSH2_SESSION *session, int reason, const char *description, const char *lang); int libssh2_session_disconnect(LIBSSH2_SESSION *session, const char *description); Descriptionsession – Session instance as returned by libssh2_session_init_ex(3) reason – One of the Disconnect Reason constants. description – Human readable reason for disconnection. lang – Localization string describing the langauge/encoding of…

libssh2_session_disconnect – convenience macro for libssh2_session_disconnect_ex(3) calls Synopsis#include <libssh2.h> int libssh2_session_disconnect(LIBSSH2_SESSION *session, const char *description); DescriptionThis is a macro defined in a public libssh2 header file that is using the underlying function libssh2_session_disconnect_ex(3). Return ValueSee libssh2_session_disconnect_ex(3) ErrorsSee libssh2_session_disconnect_ex(3) See Alsolibssh2_session_disconnect_ex(3)

libssh2_session_callback_set – set a callback function Synopsis#include <libssh2.h> void *libssh2_session_callback_set(LIBSSH2_SESSION *session, int cbtype, void *callback);DescriptionSets a custom callback handler for a previously initialized session object. Callbacks are triggered by the receipt of special packets at the Transport layer. To disable a callback, set it to NULL. session – Session instance as returned by libssh2_session_init_ex(3) cbtype…

libssh2_session_block_directions – get directions to wait for Synopsis#include <libssh2.h> int libssh2_session_block_directions(LIBSSH2_SESSION *session); Descriptionsession – Session instance as returned by libssh2_session_init_ex(3) When any of libssh2 functions return LIBSSH2_ERROR_EAGAIN an application should wait for the socket to have data available for reading or writing. Depending on the return value of libssh2_session_block_directions(3) an application should wait for read,…

libssh2_session_banner_set – set the SSH prococol banner for the local client Synopsis#include <libssh2.h> int libssh2_session_banner_set(LIBSSH2_SESSION *session, const char *banner); Descriptionsession – Session instance as returned by libssh2_session_init_ex(3) banner – A pointer to a zero-terminated string holding the user defined banner Set the banner that will be sent to the remote host when the SSH session…

libssh2_session_banner_get – get the remote banner Synopsis#include <libssh2.h> const char *libssh2_session_banner_get(oLIBSSH2_SESSION *session); DescriptionOnce the session has been setup and libssh2_session_handshake(3) has completed successfully, this function can be used to get the server id from the banner each server presents. Return ValueA pointer to a string or NULL if something failed. The data pointed to will…