Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

libssh2_userauth_list (3ssh2)

Name

libssh2_userauth_list - list supported authentication methods

Synopsis

#include <libssh2.h>

char *
libssh2_userauth_list(LIBSSH2_SESSION *session, const char *username,
unsigned int username_len);

Description

libssh2 manual                                    libssh2_userauth_list(3ssh2)



NAME
       libssh2_userauth_list - list supported authentication methods

SYNOPSIS
       #include <libssh2.h>

       char *
       libssh2_userauth_list(LIBSSH2_SESSION *session, const char *username,
                             unsigned int username_len);

DESCRIPTION
       session - Session instance as returned by libssh2_session_init_ex(3)

       username  - Username which will be used while authenticating. Note that
       most server implementations do  not  permit  attempting  authentication
       with  different  usernames between requests. Therefore this must be the
       same username you will use on later userauth calls.

       username_len - Length of username parameter.

       Send a SSH_USERAUTH_NONE request to the remote host. Unless the  remote
       host  is  configured  to  accept none as a viable authentication scheme
       (unlikely), it will return SSH_USERAUTH_FAILURE along with a listing of
       what authentication schemes it does support. In the unlikely event that
       none authentication succeeds, this method with return NULL.  This  case
       may  be  distinguished  from  a failing case by examining libssh2_user-
       auth_authenticated(3).

RETURN VALUE
       On success a comma delimited list of supported authentication  schemes.
       This list is internally managed by libssh2.  On failure returns NULL.

ERRORS
       LIBSSH2_ERROR_ALLOC -  An internal memory allocation call failed.

       LIBSSH2_ERROR_SOCKET_SEND - Unable to send data on socket.

       LIBSSH2_ERROR_EAGAIN - Marked for non-blocking I/O but the call


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_userauth_list(3ssh2)