---
name: "libssh2_session_banner_get"
section: "3"
platform: "linux"
package: "libssh2"
version: "1.11.1-7"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/libssh2_session_banner_get"
---

# libssh2\_session\_banner\_get(3)

get the remote banner

## NAME

libssh2\_session\_banner\_get - get the remote banner

## SYNOPSIS

```
#include <libssh2.h>
const char *
libssh2_session_banner_get(oLIBSSH2_SESSION *session);
```

## DESCRIPTION

Once the session has been setup and *[libssh2\_session\_handshake(3)](/libssh2_session_handshake/3.md)* has completed successfully, this function can be used to get the server id from the banner each server presents.

## RETURN VALUE

A pointer to a string or NULL if something failed. The data pointed to will be allocated and associated to the session handle and will be freed by libssh2 when *[libssh2\_session\_free(3)](/libssh2_session_free/3.md)* is used.

## AVAILABILITY

Added in 1.4.0

## SEE ALSO

**[libssh2\_session\_banner\_set(3)](/libssh2_session_banner_set/3.md),** **[libssh2\_session\_handshake(3)](/libssh2_session_handshake/3.md),** **[libssh2\_session\_free(3)](/libssh2_session_free/3.md)**