mirror of
https://github.com/libssh2/libssh2.git
synced 2025-10-30 12:05:34 +03:00
592e2b37fa
- simplify `.TH` headers. - delete empty lines before sections. - update template with an `AVAILABILITY` section. Left libssh2 version number in the `.TH` header for entries without an `AVAILABILITY` section, or where there was a different version number there.
47 lines
1.8 KiB
Groff
47 lines
1.8 KiB
Groff
.TH libssh2_session_init_ex 3 "1 Jun 2007" "libssh2 0.15" "libssh2"
|
|
.SH NAME
|
|
libssh2_session_init_ex - initializes an SSH session object
|
|
.SH SYNOPSIS
|
|
.nf
|
|
#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);
|
|
.fi
|
|
.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.
|
|
.SH SEE ALSO
|
|
.BR libssh2_session_free(3)
|
|
.BR libssh2_session_handshake(3)
|