diff options
author | Andreas Schneider <asn@cryptomilk.org> | 2011-03-06 14:22:13 +0100 |
---|---|---|
committer | Andreas Schneider <asn@cryptomilk.org> | 2011-03-06 14:25:21 +0100 |
commit | 6754c347117d8450c11f7ad3931caa7584820cfc (patch) | |
tree | 4b42b56d34312d7aa2343fcaec6448833b0b090f /include | |
parent | 7e9d384ec86e1bb1700dd93cb3586bc76de632cd (diff) | |
download | libssh-6754c347117d8450c11f7ad3931caa7584820cfc.tar.gz libssh-6754c347117d8450c11f7ad3931caa7584820cfc.tar.xz libssh-6754c347117d8450c11f7ad3931caa7584820cfc.zip |
doc: Improved documentation for server options.
Diffstat (limited to 'include')
-rw-r--r-- | include/libssh/server.h | 61 |
1 files changed, 57 insertions, 4 deletions
diff --git a/include/libssh/server.h b/include/libssh/server.h index d107f7e9..50895fe1 100644 --- a/include/libssh/server.h +++ b/include/libssh/server.h @@ -87,10 +87,63 @@ LIBSSH_API ssh_bind ssh_bind_new(void); * * @param sshbind The ssh server bind to configure. * - * @param type Option to set up. - * @param value Value to set. - * @returns SSH_OK No error. - * @returns SSH_ERROR Invalid option or parameter. + * @param type The option type to set. This could be one of the + * following: + * + * - SSH_BIND_OPTIONS_BINDADDR + * The ip address to bind (const char *). + * + * - SSH_BIND_OPTIONS_BINDPORT + * The port to bind (unsigned int). + * + * - SSH_BIND_OPTIONS_BINDPORT_STR + * The port to bind (const char *). + * + * - SSH_BIND_OPTIONS_HOSTKEY + * This specifies the file containing the private host key used + * by SSHv1. (const char *). + * + * - SSH_BIND_OPTIONS_DSAKEY + * This specifies the file containing the private host dsa key + * used by SSHv2. (const char *). + * + * - SSH_BIND_OPTIONS_RSAKEY + * This specifies the file containing the private host dsa key + * used by SSHv2. (const char *). + * + * - SSH_BIND_OPTIONS_BANNER + * That the server banner (version string) for SSH. + * (const char *). + * + * - SSH_BIND_OPTIONS_LOG_VERBOSITY + * Set the session logging verbosity (int).\n + * \n + * The verbosity of the messages. Every log smaller or + * equal to verbosity will be shown. + * - SSH_LOG_NOLOG: No logging + * - SSH_LOG_RARE: Rare conditions or warnings + * - SSH_LOG_ENTRY: API-accessible entrypoints + * - SSH_LOG_PACKET: Packet id and size + * - SSH_LOG_FUNCTIONS: Function entering and leaving + * + * - SSH_BIND_OPTIONS_LOG_VERBOSITY_STR + * Set the session logging verbosity (const char *).\n + * \n + * The verbosity of the messages. Every log smaller or + * equal to verbosity will be shown. + * - SSH_LOG_NOLOG: No logging + * - SSH_LOG_RARE: Rare conditions or warnings + * - SSH_LOG_ENTRY: API-accessible entrypoints + * - SSH_LOG_PACKET: Packet id and size + * - SSH_LOG_FUNCTIONS: Function entering and leaving + * \n + * See the corresponding numbers in libssh.h. + * + * @param value The value to set. This is a generic pointer and the + * datatype which is used should be set according to the + * type set. + * + * @returns SSH_OK on success, SSH_ERROR on invalid option or parameter. */ LIBSSH_API int ssh_bind_options_set(ssh_bind sshbind, enum ssh_bind_options_e type, const void *value); |