| .\" $Id: libssh2_hostkey_hash.3,v 1.2 2009/03/17 10:34:27 bagder Exp $ |
| .\" |
| .TH libssh2_hostkey_hash 3 "1 Jun 2007" "libssh2 0.15" "libssh2 manual" |
| .SH NAME |
| libssh2_hostkey_hash - return a hash of the remote host's key |
| .SH SYNOPSIS |
| #include <libssh2.h> |
| |
| const char * |
| libssh2_hostkey_hash(LIBSSH2_SESSION *session, int hash_type); |
| |
| .SH DESCRIPTION |
| \fIsession\fP - Session instance as returned by |
| .BR libssh2_session_init_ex(3) |
| |
| \fIhash_type\fP - One of: \fBLIBSSH2_HOSTKEY_HASH_MD5\fP or |
| \fBLIBSSH2_HOSTKEY_HASH_SHA1\fP. |
| |
| Returns the computed digest of the remote system's hostkey. The length of |
| the returned string is hash_type specific (e.g. 16 bytes for MD5, |
| 20 bytes for SHA1). |
| .SH RETURN VALUE |
| Computed hostkey hash value. or NULL if the session has not yet been started |
| up. (The hash consists of raw binary bytes, not hex digits, so is not |
| directly printable.) |
| .SH SEE ALSO |
| .BR libssh2_session_init_ex(3) |