8cd76af353
host so we now only return pointers to structs instead of having the app allocate a full struct I moved the private struct definition into knownhosts.c instead of exposing it wider in libssh2_priv.h I thus modified the proto for two functions that previously used 'struct libssh2_knownhost *' to receive data.
36 lines
1.1 KiB
Groff
36 lines
1.1 KiB
Groff
.\"
|
|
.\" 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)
|