| /* Copyright (c) 2004-2006, Sara Golemon <sarag@libssh2.org> |
| * All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, |
| * with or without modification, are permitted provided |
| * that the following conditions are met: |
| * |
| * Redistributions of source code must retain the above |
| * copyright notice, this list of conditions and the |
| * following disclaimer. |
| * |
| * Redistributions in binary form must reproduce the above |
| * copyright notice, this list of conditions and the following |
| * disclaimer in the documentation and/or other materials |
| * provided with the distribution. |
| * |
| * Neither the name of the copyright holder nor the names |
| * of any other contributors may be used to endorse or |
| * promote products derived from this software without |
| * specific prior written permission. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND |
| * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, |
| * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
| * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
| * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR |
| * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
| * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR |
| * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
| * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, |
| * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING |
| * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE |
| * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY |
| * OF SUCH DAMAGE. |
| */ |
| |
| /* Note: This include file is only needed for using the |
| * publickey SUBSYSTEM which is not the same as publickey |
| * authentication. For authentication you only need libssh2.h |
| * |
| * For more information on the publickey subsystem, |
| * refer to IETF draft: secsh-publickey |
| */ |
| |
| #ifndef LIBSSH2_PUBLICKEY_H |
| #define LIBSSH2_PUBLICKEY_H 1 |
| |
| #include "libssh2.h" |
| |
| typedef struct _LIBSSH2_PUBLICKEY LIBSSH2_PUBLICKEY; |
| |
| typedef struct _libssh2_publickey_attribute { |
| const char *name; |
| unsigned long name_len; |
| const char *value; |
| unsigned long value_len; |
| char mandatory; |
| } libssh2_publickey_attribute; |
| |
| typedef struct _libssh2_publickey_list { |
| unsigned char *packet; /* For freeing */ |
| |
| const unsigned char *name; |
| unsigned long name_len; |
| const unsigned char *blob; |
| unsigned long blob_len; |
| unsigned long num_attrs; |
| libssh2_publickey_attribute *attrs; /* free me */ |
| } libssh2_publickey_list; |
| |
| /* Generally use the first macro here, but if both name and value are string |
| literals, you can use _fast() to take advantage of preprocessing */ |
| #define libssh2_publickey_attribute(name, value, mandatory) \ |
| { (name), strlen(name), (value), strlen(value), (mandatory) }, |
| #define libssh2_publickey_attribute_fast(name, value, mandatory) \ |
| { (name), sizeof(name) - 1, (value), sizeof(value) - 1, (mandatory) }, |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| /* Publickey Subsystem */ |
| LIBSSH2_API LIBSSH2_PUBLICKEY *libssh2_publickey_init(LIBSSH2_SESSION *session); |
| |
| LIBSSH2_API int libssh2_publickey_add_ex(LIBSSH2_PUBLICKEY *pkey, |
| const unsigned char *name, |
| unsigned long name_len, |
| const unsigned char *blob, |
| unsigned long blob_len, char overwrite, |
| unsigned long num_attrs, |
| const libssh2_publickey_attribute attrs[]); |
| #define libssh2_publickey_add(pkey, name, blob, blob_len, overwrite, \ |
| num_attrs, attrs) \ |
| libssh2_publickey_add_ex((pkey), (name), strlen(name), (blob), (blob_len), \ |
| (overwrite), (num_attrs), (attrs)) |
| |
| LIBSSH2_API int libssh2_publickey_remove_ex(LIBSSH2_PUBLICKEY *pkey, |
| const unsigned char *name, |
| unsigned long name_len, |
| const unsigned char *blob, |
| unsigned long blob_len); |
| #define libssh2_publickey_remove(pkey, name, blob, blob_len) \ |
| libssh2_publickey_remove_ex((pkey), (name), strlen(name), (blob), (blob_len)) |
| |
| LIBSSH2_API int |
| libssh2_publickey_list_fetch(LIBSSH2_PUBLICKEY *pkey, |
| unsigned long *num_keys, |
| libssh2_publickey_list **pkey_list); |
| LIBSSH2_API void libssh2_publickey_list_free(LIBSSH2_PUBLICKEY *pkey, |
| libssh2_publickey_list *pkey_list); |
| |
| LIBSSH2_API int libssh2_publickey_shutdown(LIBSSH2_PUBLICKEY *pkey); |
| |
| #ifdef __cplusplus |
| } /* extern "C" */ |
| #endif |
| |
| #endif /* ifndef: LIBSSH2_PUBLICKEY_H */ |