Current File : //usr/man/man3ssh2/libssh2_session_init_ex.3ssh2

'\" te
.TH libssh2_session_init_ex 3 "1 Jun 2007" "libssh2 0.15" "libssh2 manual"
.SH NAME
libssh2_session_init_ex - initializes an SSH session object
.SH 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);

.SH DESCRIPTION
\fImyalloc\fP - 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.

\fImyfree\fP - 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.

\fImyrealloc\fP - 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.

\fIabstract\fP - 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.
.SH RETURN VALUE
Pointer to a newly allocated LIBSSH2_SESSION instance, or NULL on errors.

.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE 
=
Availability	library/libssh2
=
Stability	Uncommitted
.TE 
.PP
.SH SEE ALSO
.BR libssh2_session_free(3)
.BR libssh2_session_handshake(3)


.SH NOTES

.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland.  The original community source was downloaded from  http://www.libssh2.org/download/libssh2-1.4.2.tar.gz

Further information about this software can be found on the open source community website at http://www.libssh2.org/.