libssh2\_agent\_get\_identity(3) libssh2 libssh2\_agent\_get\_identity(3)

# [NAME](#NAME)

libssh2\_agent\_get\_identity - get a public key off the collection of public keys managed by ssh-agent

# [SYNOPSIS](#SYNOPSIS)

```
#include <libssh2.h>
int
libssh2_agent_get_identity(LIBSSH2_AGENT *agent,


                           struct libssh2_agent_publickey **store,


                           struct libssh2_agent_publickey *prev);
```

# [DESCRIPTION](#DESCRIPTION)

[*libssh2\_agent\_get\_identity(3)*](/man/os/libssh2/libssh2_agent_get_identity.3) allows an application to iterate over all public keys in the collection managed by ssh-agent.

*store* should point to a pointer that gets filled in to point to the public key data.

*prev* is a pointer to a previous 'struct libssh2\_agent\_publickey' as returned by a previous invoke of this function, or NULL to get the first entry in the internal collection.

# [RETURN VALUE](#RETURN_VALUE)

Returns 0 if everything is fine and information about a host was stored in the *store* struct.

Returns 1 if it reached the end of public keys.

Returns negative values for error

# [AVAILABILITY](#AVAILABILITY)

Added in libssh2 1.2

# [SEE ALSO](#SEE_ALSO)

[**libssh2\_agent\_list\_identities(3)**](/man/os/libssh2/libssh2_agent_list_identities.3) [**libssh2\_agent\_userauth(3)**](/man/os/libssh2/libssh2_agent_userauth.3)

23 Dec 2009 libssh2

---

Document: libssh2_agent_get_identity(3) from libssh2 1.11.1-r10 (Chainguard OS)
Source: https://github.com/libssh2/libssh2.git