libssh2_session_init_ex - Man Page

initializes an SSH session object


#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);


myalloc - 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 on Callbacks  for implementing a deallocator callback. Pass a value of NULL to use the  default system deallocator.

myrealloc - Custom re-allocator function. Refer to the section on  Callbacks for implementing a reallocator callback. Pass a value of NULL to  use the default system reallocator.

abstract - Arbitrary pointer to application specific callback data.  This value will be passed to any callback function associated with the named  session instance.

Initializes an SSH session object. By default system memory allocators (malloc(), free(), realloc()) will be used for any dynamically allocated memory blocks. Alternate memory allocation functions may be specified using the extended version of this API call, and/or optional application specific data may be attached to the session object.

This method must be called first, prior to configuring session options or starting up an SSH session with a remote server.

Return Value

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

See Also

libssh2_session_free(3) libssh2_session_handshake(3)

Referenced By

libssh2_banner_set(3), libssh2_channel_direct_tcpip_ex(3), libssh2_channel_open_ex(3), libssh2_free(3), libssh2_hostkey_hash(3), libssh2_scp_recv(3), libssh2_scp_recv2(3), libssh2_scp_send64(3), libssh2_scp_send_ex(3), libssh2_session_abstract(3), libssh2_session_banner_set(3), libssh2_session_block_directions(3), libssh2_session_callback_set(3), libssh2_session_disconnect_ex(3), libssh2_session_free(3), libssh2_session_handshake(3), libssh2_session_init(3), libssh2_session_last_errno(3), libssh2_session_last_error(3), libssh2_session_method_pref(3), libssh2_session_methods(3), libssh2_session_set_blocking(3), libssh2_session_set_last_error(3), libssh2_session_startup(3), libssh2_sftp_init(3), libssh2_userauth_authenticated(3), libssh2_userauth_keyboard_interactive_ex(3), libssh2_userauth_list(3), libssh2_userauth_password_ex(3), libssh2_userauth_publickey_fromfile_ex(3), libssh2_userauth_publickey_frommemory(3).

1 Jun 2007 libssh2 0.15 libssh2 manual