119 lines
4.8 KiB
C
119 lines
4.8 KiB
C
/* 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 */
|