diff options
author | Andreas Schneider <asn@cryptomilk.org> | 2011-03-09 18:32:09 +0100 |
---|---|---|
committer | Andreas Schneider <asn@cryptomilk.org> | 2011-03-09 18:33:03 +0100 |
commit | 7daa81f3aa876acb69a9cb332391dd218ac6838c (patch) | |
tree | 308e28f625194d350996e717a56a8189c1ac38de | |
parent | 6754c347117d8450c11f7ad3931caa7584820cfc (diff) | |
download | libssh-7daa81f3aa876acb69a9cb332391dd218ac6838c.tar.gz libssh-7daa81f3aa876acb69a9cb332391dd218ac6838c.tar.xz libssh-7daa81f3aa876acb69a9cb332391dd218ac6838c.zip |
doc: Improve the doc of ssh_bind_set_callbacks.
-rw-r--r-- | include/libssh/server.h | 20 | ||||
-rw-r--r-- | src/bind.c | 19 |
2 files changed, 20 insertions, 19 deletions
diff --git a/include/libssh/server.h b/include/libssh/server.h index 50895fe..d0cdd2d 100644 --- a/include/libssh/server.h +++ b/include/libssh/server.h @@ -157,6 +157,26 @@ LIBSSH_API int ssh_bind_options_set(ssh_bind sshbind, */ LIBSSH_API int ssh_bind_listen(ssh_bind ssh_bind_o); +/** + * @brief Set the callback for this bind. + * + * @param[in] sshbind The bind to set the callback on. + * + * @param[in] callbacks An already set up ssh_bind_callbacks instance. + * + * @param[in] userdata A pointer to private data to pass to the callbacks. + * + * @return SSH_OK on success, SSH_ERROR if an error occured. + * + * @code + * struct ssh_callbacks_struct cb = { + * .userdata = data, + * .auth_function = my_auth_function + * }; + * ssh_callbacks_init(&cb); + * ssh_bind_set_callbacks(session, &cb); + * @endcode + */ LIBSSH_API int ssh_bind_set_callbacks(ssh_bind sshbind, ssh_bind_callbacks callbacks, void *userdata); @@ -186,25 +186,6 @@ int ssh_bind_listen(ssh_bind sshbind) { return 0; } -/** - * @brief set the bind callbacks for ssh_bind - * @code - * struct ssh_callbacks_struct cb = { - * .userdata = data, - * .auth_function = my_auth_function - * }; - * ssh_callbacks_init(&cb); - * ssh_set_callbacks(session, &cb); - * @endcode - * @param sshbind the ssh_bind structure to set - * @param callbacks a ssh_bind_callbacks instance already set up. Do - * use ssh_callbacks_init() to initialize it. - * @param userdata userdata to be used with each callback called - * within callbacks. - * @returns SSH_OK on success, - * SSH_ERROR on error. - */ - int ssh_bind_set_callbacks(ssh_bind sshbind, ssh_bind_callbacks callbacks, void *userdata){ if (sshbind == NULL) { |