libssh2_knownhost_get.3 (1134B)
1.\" 2.\" Copyright (c) 2009 by Daniel Stenberg 3.\" 4.TH libssh2_knownhost_get 3 "28 May 2009" "libssh2" "libssh2" 5.SH NAME 6libssh2_knownhost_get - get a known host off the collection of known hosts 7.SH SYNOPSIS 8.nf 9#include <libssh2.h> 10 11int 12libssh2_knownhost_get(LIBSSH2_KNOWNHOSTS *hosts, 13 struct libssh2_knownhost **store, 14 struct libssh2_knownhost *prev): 15.fi 16.SH DESCRIPTION 17\fIlibssh2_knownhost_get(3)\fP allows an application to iterate over all known 18hosts in the collection. 19 20\fIstore\fP should point to a pointer that gets filled in to point to the 21known host data. 22 23\fIprev\fP is a pointer to a previous 'struct libssh2_knownhost' as returned 24by a previous invoke of this function, or NULL to get the first entry in the 25internal 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 hosts. 31 32Returns negative values for error 33.SH AVAILABILITY 34Added in libssh2 1.2 35.SH SEE ALSO 36.BR libssh2_knownhost_readfile(3) 37.BR libssh2_knownhost_writefile(3) 38.BR libssh2_knownhost_add(3)