libssh2_agent_get_identity(3)

libssh2_agent_get_identity(3libssh2 manualibssh2_agent_get_identity(3)

NAME

     libssh2_agent_get_identity - get a public key off  the  col-
     lection 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  inter-
     nal 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

SEE ALSO

     libssh2_agent_list_identities(3) libssh2_agent_userauth(3)

libssh2 1.2         Last change: 23 Dec 2009                    1