libssh2_agent_get_identity - get a public key off the collection of public keys managed by ssh-agent
#include <libssh2.h> int libssh2_agent_get_identity(LIBSSH2_AGENT *agent, struct libssh2_agent_publickey **store, struct libssh2_agent_publickey *prev);
libssh2 manual libssh2_agent_get_identity(3ssh2)
NAME
libssh2_agent_get_identity - get a public key off the collection of
public keys managed by ssh-agent
SYNOPSIS
#include <libssh2.h>
int libssh2_agent_get_identity(LIBSSH2_AGENT *agent,
struct libssh2_agent_publickey **store,
struct libssh2_agent_publickey *prev);
DESCRIPTION
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
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
Added in libssh2 1.2
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/libssh2 |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
SEE ALSO
libssh2_agent_list_identities(3) libssh2_agent_userauth(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 1.2 23 Dec 2009
libssh2_agent_get_identity(3ssh2)