libssh2\_userauth\_banner(3) libssh2 libssh2\_userauth\_banner(3) # [NAME](#NAME) libssh2\_userauth\_banner - get the server's userauth banner message # [SYNOPSIS](#SYNOPSIS) ``` #include int libssh2_userauth_banner(LIBSSH2_SESSION *session, char **banner); ``` # [DESCRIPTION](#DESCRIPTION) *session* - Session instance as returned by [**libssh2\_session\_init\_ex(3)**](/man/os/libssh2/libssh2_session_init_ex.3) *banner* - Should point to a pointer that gets filled with banner message. After an authentication has been attempted, such as a **SSH\_USERAUTH\_NONE** request sent by [**libssh2\_userauth\_list(3)**](/man/os/libssh2/libssh2_userauth_list.3), this function can be called to retrieve the userauth banner sent by the server. If no such banner is sent, or if an authentication has not yet been attempted, returns LIBSSH2\_ERROR\_MISSING\_USERAUTH\_BANNER. # [RETURN VALUE](#RETURN_VALUE) On success returns 0 and an UTF-8 NUL-terminated string is stored in the *banner*. This string is internally managed by libssh2 and will be deallocated upon session termination. On failure returns LIBSSH2\_ERROR\_MISSING\_USERAUTH\_BANNER. # [SEE ALSO](#SEE_ALSO) **[libssh2\_session\_init\_ex(3)](/man/os/libssh2/libssh2_session_init_ex.3),** [**libssh2\_userauth\_list(3)**](/man/os/libssh2/libssh2_userauth_list.3) 1 Jun 2021 libssh2 1.9.0 --- Document: libssh2_userauth_banner(3) from libssh2 1.11.1-r11 (Chainguard OS) Source: https://github.com/libssh2/libssh2.git