Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

libssh2_session_disconnect_ex (3ssh2)

Name

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

Description

libssh2 manual                            libssh2_session_disconnect_ex(3ssh2)



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


DESCRIPTION
       session - 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 language/encoding of the
       description provided.

       Send a disconnect message to the remote host associated  with  session,
       along with a reason symbol and a verbose description.

       As  a convenience, the macro libssh2_session_disconnect(3) is provided.
       It calls libssh2_session_disconnect_ex(3) with reason set  to  SSH_DIS-
       CONNECT_BY_APPLICATION and lang set to an empty string.


RETURN VALUE
       Return   0  on  success  or  negative  on  failure.   It  returns  LIB-
       SSH2_ERROR_EAGAIN  when  it   would   otherwise   block.   While   LIB-
       SSH2_ERROR_EAGAIN  is  a negative number, it isn't really a failure per
       se.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/libssh2  |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       libssh2_session_init_ex(3)



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source  was  downloaded   from    https://www.libssh2.org/download/lib-
       ssh2-1.10.0.tar.gz.

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



libssh2 0.15                      1 Jun 2007
                                          libssh2_session_disconnect_ex(3ssh2)