libssh2_agent_get_identity.3 (1189B)
1.\" 2.\" Copyright (c) 2009 by Daiki Ueno 3.\" 4.TH libssh2_agent_get_identity 3 "23 Dec 2009" "libssh2" "libssh2" 5.SH NAME 6libssh2_agent_get_identity - get a public key off the collection of public keys managed by ssh-agent 7.SH SYNOPSIS 8.nf 9#include <libssh2.h> 10 11int 12libssh2_agent_get_identity(LIBSSH2_AGENT *agent, 13 struct libssh2_agent_publickey **store, 14 struct libssh2_agent_publickey *prev); 15.fi 16.SH DESCRIPTION 17\fIlibssh2_agent_get_identity(3)\fP allows an application to iterate 18over all public keys in the collection managed by ssh-agent. 19 20\fIstore\fP should point to a pointer that gets filled in to point to the 21public key data. 22 23\fIprev\fP is a pointer to a previous 'struct libssh2_agent_publickey' 24as returned by a previous invoke of this function, or NULL to get the 25first entry in the internal collection. 26.SH RETURN VALUE 27Returns 0 if everything is fine and information about a host was stored in 28the \fIstore\fP struct. 29 30Returns 1 if it reached the end of public keys. 31 32Returns negative values for error 33.SH AVAILABILITY 34Added in libssh2 1.2 35.SH SEE ALSO 36.BR libssh2_agent_list_identities(3) 37.BR libssh2_agent_userauth(3)