125 lines
3.3 KiB
C
125 lines
3.3 KiB
C
/* gpgme.h - GnuPG Made Easy
|
|
* Copyright (C) 2000 Werner Koch (dd9jn)
|
|
*
|
|
* This file is part of GPGME.
|
|
*
|
|
* GPGME is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* GPGME is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
|
|
*/
|
|
|
|
#ifndef GPGME_H
|
|
#define GPGME_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#if 0 /* just to make Emacs auto-indent happy */
|
|
}
|
|
#endif
|
|
#endif
|
|
|
|
struct gpgme_context_s;
|
|
typedef struct gpgme_context_s *GpgmeCtx;
|
|
|
|
struct gpgme_data_s;
|
|
typedef struct gpgme_data_s *GpgmeData;
|
|
|
|
struct gpgme_recipient_set_s;
|
|
typedef struct gpgme_recipient_set_s *GpgmeRecipientSet;
|
|
|
|
|
|
typedef enum {
|
|
GPGME_EOF = -1,
|
|
GPGME_No_Error = 0,
|
|
GPGME_General_Error = 1,
|
|
GPGME_Out_Of_Core = 2,
|
|
GPGME_Invalid_Value = 3,
|
|
GPGME_Busy = 4,
|
|
GPGME_No_Request = 5,
|
|
GPGME_Exec_Error = 6,
|
|
GPGME_Too_Many_Procs = 7,
|
|
GPGME_Pipe_Error = 8,
|
|
GPGME_No_Recipients = 9,
|
|
GPGME_No_Data = 10,
|
|
GPGME_Conflict = 11,
|
|
GPGME_Not_Implemented = 12,
|
|
GPGME_Read_Error = 13,
|
|
GPGME_Write_Error = 14,
|
|
GPGME_Invalid_Type = 15,
|
|
GPGME_Invalid_Mode = 16,
|
|
} GpgmeError;
|
|
|
|
typedef enum {
|
|
GPGME_DATA_TYPE_NONE = 0,
|
|
GPGME_DATA_TYPE_MEM = 1,
|
|
GPGME_DATA_TYPE_FD = 2,
|
|
GPGME_DATA_TYPE_FILE = 3
|
|
} GpgmeDataType;
|
|
|
|
|
|
/* Context management */
|
|
GpgmeError gpgme_new_context (GpgmeCtx *r_ctx);
|
|
void gpgme_release_context ( GpgmeCtx c );
|
|
GpgmeCtx gpgme_wait ( GpgmeCtx c, int hang );
|
|
|
|
/* Functions to handle recipients */
|
|
GpgmeError gpgme_new_recipient_set (GpgmeRecipientSet *r_rset);
|
|
void gpgme_release_recipient_set ( GpgmeRecipientSet rset);
|
|
GpgmeError gpgme_add_recipient (GpgmeRecipientSet rset, const char *name);
|
|
unsigned int gpgme_count_recipients ( const GpgmeRecipientSet rset );
|
|
|
|
/* Functions to handle data sources */
|
|
GpgmeError gpgme_new_data ( GpgmeData *r_dh,
|
|
const char *buffer, size_t size, int copy );
|
|
void gpgme_release_data ( GpgmeData dh );
|
|
GpgmeDataType gpgme_query_data_type ( GpgmeData dh );
|
|
GpgmeError gpgme_rewind_data ( GpgmeData dh );
|
|
GpgmeError gpgme_read_data ( GpgmeData dh,
|
|
char *buffer, size_t length, size_t *nread );
|
|
|
|
|
|
|
|
/* Basic GnuPG functions */
|
|
GpgmeError gpgme_start_encrypt ( GpgmeCtx c, GpgmeRecipientSet recp,
|
|
GpgmeData in, GpgmeData out );
|
|
GpgmeError gpgme_start_verify ( GpgmeCtx c, GpgmeData sig, GpgmeData text );
|
|
|
|
|
|
/* Key management functions */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Convenience functions for syncronous usage */
|
|
GpgmeError gpgme_encrypt ( GpgmeCtx c, GpgmeRecipientSet recp,
|
|
GpgmeData in, GpgmeData out );
|
|
GpgmeError gpgme_verify ( GpgmeCtx c, GpgmeData sig, GpgmeData text );
|
|
|
|
|
|
/* miscellaneous functions */
|
|
const char *gpgme_strerror (GpgmeError err);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* GPGME_H */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|