mirror of
https://github.com/libssh2/libssh2.git
synced 2025-04-26 16:48:48 +03:00
e590450dcc
- add missing `.fi` tags. - fix misplaced `.nf` tags. - add `.nf`/`.fi` tags `SYNOPSIS` where missing. - fix missing/wrong function name from `SH NAME`. - fix wrong function name in `TH`. - keep return values in a separate line. - indent. - fold long lines. - deleted `libssh2_channel_direct_streamlocal()`, there is no such function. - add missing types. - add missing headers. Closes #949
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 manual"
|
|
.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)
|