|
- .\"
- .\" Copyright (c) 2009 by Daniel Stenberg
- .\"
- .TH libssh2_knownhost_get 3 "28 May 2009" "libssh2 1.2" "libssh2 manual"
- .SH NAME
- libssh2_knownhost_get - get a known host off the collection of known hosts
- .SH SYNOPSIS
- #include <libssh2.h>
-
- int libssh2_knownhost_get(LIBSSH2_KNOWNHOSTS *hosts,
- struct libssh2_knownhost **store,
- struct libssh2_knownhost *prev):
- .SH DESCRIPTION
- \fIlibssh2_knownhost_get(3)\fP allows an application to iterate over all known
- hosts in the collection.
-
- \fIstore\fP should point to a pointer that gets filled in to point to the
- known host data.
-
- \fIprev\fP is a pointer to a previous 'struct libssh2_knownhost' as returned
- by a previous invoke of this function, or NULL to get the first entry in the
- internal collection.
- .SH RETURN VALUE
- Returns 0 if everything is fine and information about a host was stored in
- the \fIstore\fP struct.
-
- Returns 1 if it reached the end of hosts.
-
- Returns negative values for error
- .SH AVAILABILITY
- Added in libssh2 1.2
- .SH SEE ALSO
- .BR libssh2_knownhost_readfile(3)
- .BR libssh2_knownhost_writefile(3)
- .BR libssh2_knownhost_add(3)
|