Loading...
Searching...
No Matches
cipher.h
Go to the documentation of this file.
/* purple
*
* Purple is the legal property of its developers, whose names are too numerous
* to list here. Please refer to the COPYRIGHT file distributed with this
* source distribution.
*
* This program 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.
*
* This program 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., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
*/
#ifndef PURPLE_CIPHER_H
#define PURPLE_CIPHER_H
#include <glib.h>
#include <string.h>
#define PURPLE_CIPHER(obj) ((PurpleCipher *)(obj))
#define PURPLE_CIPHER_OPS(obj) ((PurpleCipherOps *)(obj))
#define PURPLE_CIPHER_CONTEXT(obj) ((PurpleCipherContext *)(obj))
typedef struct _PurpleCipher PurpleCipher;
typedef struct _PurpleCipherOps PurpleCipherOps;
typedef struct _PurpleCipherContext PurpleCipherContext;
typedef enum _PurpleCipherBatchMode {
PURPLE_CIPHER_BATCH_MODE_ECB,
PURPLE_CIPHER_BATCH_MODE_CBC
} PurpleCipherBatchMode;
typedef enum _PurpleCipherCaps {
PURPLE_CIPHER_CAPS_SET_OPT = 1 << 1,
PURPLE_CIPHER_CAPS_GET_OPT = 1 << 2,
PURPLE_CIPHER_CAPS_INIT = 1 << 3,
PURPLE_CIPHER_CAPS_RESET = 1 << 4,
PURPLE_CIPHER_CAPS_UNINIT = 1 << 5,
PURPLE_CIPHER_CAPS_SET_IV = 1 << 6,
PURPLE_CIPHER_CAPS_APPEND = 1 << 7,
PURPLE_CIPHER_CAPS_DIGEST = 1 << 8,
PURPLE_CIPHER_CAPS_ENCRYPT = 1 << 9,
PURPLE_CIPHER_CAPS_DECRYPT = 1 << 10,
PURPLE_CIPHER_CAPS_SET_SALT = 1 << 11,
PURPLE_CIPHER_CAPS_GET_SALT_SIZE = 1 << 12,
PURPLE_CIPHER_CAPS_SET_KEY = 1 << 13,
PURPLE_CIPHER_CAPS_GET_KEY_SIZE = 1 << 14,
PURPLE_CIPHER_CAPS_SET_BATCH_MODE = 1 << 15,
PURPLE_CIPHER_CAPS_GET_BATCH_MODE = 1 << 16,
PURPLE_CIPHER_CAPS_GET_BLOCK_SIZE = 1 << 17,
PURPLE_CIPHER_CAPS_SET_KEY_WITH_LEN = 1 << 18,
PURPLE_CIPHER_CAPS_UNKNOWN = 1 << 19
} PurpleCipherCaps;
struct _PurpleCipherOps {
void (*set_option)(PurpleCipherContext *context, const gchar *name, void *value);
void *(*get_option)(PurpleCipherContext *context, const gchar *name);
void (*init)(PurpleCipherContext *context, void *extra);
void (*reset)(PurpleCipherContext *context, void *extra);
void (*uninit)(PurpleCipherContext *context);
void (*set_iv)(PurpleCipherContext *context, guchar *iv, size_t len);
void (*append)(PurpleCipherContext *context, const guchar *data, size_t len);
gboolean (*digest)(PurpleCipherContext *context, size_t in_len, guchar digest[], size_t *out_len);
int (*encrypt)(PurpleCipherContext *context, const guchar data[], size_t len, guchar output[], size_t *outlen);
int (*decrypt)(PurpleCipherContext *context, const guchar data[], size_t len, guchar output[], size_t *outlen);
void (*set_salt)(PurpleCipherContext *context, guchar *salt);
size_t (*get_salt_size)(PurpleCipherContext *context);
void (*set_key)(PurpleCipherContext *context, const guchar *key);
size_t (*get_key_size)(PurpleCipherContext *context);
void (*set_batch_mode)(PurpleCipherContext *context, PurpleCipherBatchMode mode);
PurpleCipherBatchMode (*get_batch_mode)(PurpleCipherContext *context);
size_t (*get_block_size)(PurpleCipherContext *context);
void (*set_key_with_len)(PurpleCipherContext *context, const guchar *key, size_t len);
};
G_BEGIN_DECLS
/*****************************************************************************/
/*****************************************************************************/
const gchar *purple_cipher_get_name(PurpleCipher *cipher);
guint purple_cipher_get_capabilities(PurpleCipher *cipher);
gboolean purple_cipher_digest_region(const gchar *name, const guchar *data, size_t data_len, size_t in_len, guchar digest[], size_t *out_len);
/******************************************************************************/
/******************************************************************************/
PurpleCipher *purple_ciphers_find_cipher(const gchar *name);
PurpleCipher *purple_ciphers_register_cipher(const gchar *name, PurpleCipherOps *ops);
gboolean purple_ciphers_unregister_cipher(PurpleCipher *cipher);
GList *purple_ciphers_get_ciphers(void);
/******************************************************************************/
/******************************************************************************/
gpointer purple_ciphers_get_handle(void);
void purple_ciphers_init(void);
void purple_ciphers_uninit(void);
/******************************************************************************/
/******************************************************************************/
void purple_cipher_context_set_option(PurpleCipherContext *context, const gchar *name, gpointer value);
gpointer purple_cipher_context_get_option(PurpleCipherContext *context, const gchar *name);
PurpleCipherContext *purple_cipher_context_new(PurpleCipher *cipher, void *extra);
PurpleCipherContext *purple_cipher_context_new_by_name(const gchar *name, void *extra);
void purple_cipher_context_reset(PurpleCipherContext *context, gpointer extra);
void purple_cipher_context_destroy(PurpleCipherContext *context);
void purple_cipher_context_set_iv(PurpleCipherContext *context, guchar *iv, size_t len);
void purple_cipher_context_append(PurpleCipherContext *context, const guchar *data, size_t len);
gboolean purple_cipher_context_digest(PurpleCipherContext *context, size_t in_len, guchar digest[], size_t *out_len);
gboolean purple_cipher_context_digest_to_str(PurpleCipherContext *context, size_t in_len, gchar digest_s[], size_t *out_len);
gint purple_cipher_context_encrypt(PurpleCipherContext *context, const guchar data[], size_t len, guchar output[], size_t *outlen);
gint purple_cipher_context_decrypt(PurpleCipherContext *context, const guchar data[], size_t len, guchar output[], size_t *outlen);
void purple_cipher_context_set_salt(PurpleCipherContext *context, guchar *salt);
size_t purple_cipher_context_get_salt_size(PurpleCipherContext *context);
void purple_cipher_context_set_key(PurpleCipherContext *context, const guchar *key);
size_t purple_cipher_context_get_key_size(PurpleCipherContext *context);
void purple_cipher_context_set_batch_mode(PurpleCipherContext *context, PurpleCipherBatchMode mode);
PurpleCipherBatchMode purple_cipher_context_get_batch_mode(PurpleCipherContext *context);
size_t purple_cipher_context_get_block_size(PurpleCipherContext *context);
void purple_cipher_context_set_key_with_len(PurpleCipherContext *context, const guchar *key, size_t len);
void purple_cipher_context_set_data(PurpleCipherContext *context, gpointer data);
gpointer purple_cipher_context_get_data(PurpleCipherContext *context);
/*****************************************************************************/
/*****************************************************************************/
gchar *purple_cipher_http_digest_calculate_session_key(
const gchar *algorithm, const gchar *username,
const gchar *realm, const gchar *password,
const gchar *nonce, const gchar *client_nonce);
gchar *purple_cipher_http_digest_calculate_response(
const gchar *algorithm, const gchar *method,
const gchar *digest_uri, const gchar *qop,
const gchar *entity, const gchar *nonce,
const gchar *nonce_count, const gchar *client_nonce,
const gchar *session_key);
G_END_DECLS
#endif /* PURPLE_CIPHER_H */
PurpleCipherBatchMode
enum _PurpleCipherBatchMode PurpleCipherBatchMode
Modes for batch encrypters.
_PurpleCipherBatchMode
_PurpleCipherBatchMode
Modes for batch encrypters.
Definition cipher.h:44
purple_ciphers_get_ciphers
GList * purple_ciphers_get_ciphers(void)
Gets the list of ciphers.
purple_cipher_digest_region
gboolean purple_cipher_digest_region(const gchar *name, const guchar *data, size_t data_len, size_t in_len, guchar digest[], size_t *out_len)
Gets a digest from a cipher.
purple_cipher_context_set_batch_mode
void purple_cipher_context_set_batch_mode(PurpleCipherContext *context, PurpleCipherBatchMode mode)
Sets the batch mode of a context.
purple_cipher_context_get_option
gpointer purple_cipher_context_get_option(PurpleCipherContext *context, const gchar *name)
Gets the vale of an option on a cipher context.
PurpleCipherOps
struct _PurpleCipherOps PurpleCipherOps
Ops for a PurpleCipher.
Definition cipher.h:38
PurpleCipherContext
struct _PurpleCipherContext PurpleCipherContext
A context for a PurpleCipher.
Definition cipher.h:39
purple_cipher_context_decrypt
gint purple_cipher_context_decrypt(PurpleCipherContext *context, const guchar data[], size_t len, guchar output[], size_t *outlen)
Decrypts data using the context.
purple_cipher_context_set_data
void purple_cipher_context_set_data(PurpleCipherContext *context, gpointer data)
Sets the cipher data for a context.
purple_ciphers_find_cipher
PurpleCipher * purple_ciphers_find_cipher(const gchar *name)
Finds a cipher by it's name.
purple_ciphers_unregister_cipher
gboolean purple_ciphers_unregister_cipher(PurpleCipher *cipher)
Unregisters a cipher.
purple_cipher_context_get_key_size
size_t purple_cipher_context_get_key_size(PurpleCipherContext *context)
Gets the key size for a context.
purple_ciphers_uninit
void purple_ciphers_uninit(void)
Uninitializes the cipher core.
purple_cipher_context_set_salt
void purple_cipher_context_set_salt(PurpleCipherContext *context, guchar *salt)
Sets the salt on a context.
purple_cipher_context_get_salt_size
size_t purple_cipher_context_get_salt_size(PurpleCipherContext *context)
Gets the size of the salt if the cipher supports it.
purple_cipher_context_set_key_with_len
void purple_cipher_context_set_key_with_len(PurpleCipherContext *context, const guchar *key, size_t len)
Sets the key with a given length on a context.
purple_cipher_context_digest_to_str
gboolean purple_cipher_context_digest_to_str(PurpleCipherContext *context, size_t in_len, gchar digest_s[], size_t *out_len)
Converts a guchar digest into a hex string.
purple_cipher_context_set_key
void purple_cipher_context_set_key(PurpleCipherContext *context, const guchar *key)
Sets the key on a context.
purple_cipher_context_set_iv
void purple_cipher_context_set_iv(PurpleCipherContext *context, guchar *iv, size_t len)
Sets the initialization vector for a context.
purple_cipher_get_capabilities
guint purple_cipher_get_capabilities(PurpleCipher *cipher)
Gets a cipher's capabilities.
purple_cipher_http_digest_calculate_response
gchar * purple_cipher_http_digest_calculate_response(const gchar *algorithm, const gchar *method, const gchar *digest_uri, const gchar *qop, const gchar *entity, const gchar *nonce, const gchar *nonce_count, const gchar *client_nonce, const gchar *session_key)
Calculate a response for HTTP Digest authentication.
purple_ciphers_get_handle
gpointer purple_ciphers_get_handle(void)
Gets the handle to the cipher subsystem.
purple_cipher_context_destroy
void purple_cipher_context_destroy(PurpleCipherContext *context)
Destorys a cipher context and deinitializes it.
purple_cipher_context_reset
void purple_cipher_context_reset(PurpleCipherContext *context, gpointer extra)
Resets a cipher context to it's default value.
_PurpleCipherCaps
_PurpleCipherCaps
The operation flags for a cipher.
Definition cipher.h:52
PURPLE_CIPHER_CAPS_GET_OPT
@ PURPLE_CIPHER_CAPS_GET_OPT
Get option flag.
Definition cipher.h:54
PURPLE_CIPHER_CAPS_SET_KEY
@ PURPLE_CIPHER_CAPS_SET_KEY
Set key flag.
Definition cipher.h:65
PURPLE_CIPHER_CAPS_SET_IV
@ PURPLE_CIPHER_CAPS_SET_IV
Set IV flag.
Definition cipher.h:58
PURPLE_CIPHER_CAPS_UNINIT
@ PURPLE_CIPHER_CAPS_UNINIT
Uninit flag.
Definition cipher.h:57
PURPLE_CIPHER_CAPS_ENCRYPT
@ PURPLE_CIPHER_CAPS_ENCRYPT
Encrypt flag.
Definition cipher.h:61
PURPLE_CIPHER_CAPS_GET_SALT_SIZE
@ PURPLE_CIPHER_CAPS_GET_SALT_SIZE
Get salt size flag.
Definition cipher.h:64
PURPLE_CIPHER_CAPS_SET_OPT
@ PURPLE_CIPHER_CAPS_SET_OPT
Set option flag.
Definition cipher.h:53
PURPLE_CIPHER_CAPS_INIT
@ PURPLE_CIPHER_CAPS_INIT
Init flag.
Definition cipher.h:55
PURPLE_CIPHER_CAPS_GET_BLOCK_SIZE
@ PURPLE_CIPHER_CAPS_GET_BLOCK_SIZE
The get block size flag.
Definition cipher.h:69
PURPLE_CIPHER_CAPS_SET_KEY_WITH_LEN
@ PURPLE_CIPHER_CAPS_SET_KEY_WITH_LEN
The set key with length flag.
Definition cipher.h:70
PURPLE_CIPHER_CAPS_DECRYPT
@ PURPLE_CIPHER_CAPS_DECRYPT
Decrypt flag.
Definition cipher.h:62
PURPLE_CIPHER_CAPS_UNKNOWN
@ PURPLE_CIPHER_CAPS_UNKNOWN
Unknown.
Definition cipher.h:71
PURPLE_CIPHER_CAPS_SET_SALT
@ PURPLE_CIPHER_CAPS_SET_SALT
Set salt flag.
Definition cipher.h:63
PURPLE_CIPHER_CAPS_RESET
@ PURPLE_CIPHER_CAPS_RESET
Reset flag.
Definition cipher.h:56
PURPLE_CIPHER_CAPS_GET_BATCH_MODE
@ PURPLE_CIPHER_CAPS_GET_BATCH_MODE
Get batch mode flag.
Definition cipher.h:68
PURPLE_CIPHER_CAPS_SET_BATCH_MODE
@ PURPLE_CIPHER_CAPS_SET_BATCH_MODE
Set batch mode flag.
Definition cipher.h:67
PURPLE_CIPHER_CAPS_DIGEST
@ PURPLE_CIPHER_CAPS_DIGEST
Digest flag.
Definition cipher.h:60
PURPLE_CIPHER_CAPS_APPEND
@ PURPLE_CIPHER_CAPS_APPEND
Append flag.
Definition cipher.h:59
PURPLE_CIPHER_CAPS_GET_KEY_SIZE
@ PURPLE_CIPHER_CAPS_GET_KEY_SIZE
Get key size flag.
Definition cipher.h:66
purple_cipher_http_digest_calculate_session_key
gchar * purple_cipher_http_digest_calculate_session_key(const gchar *algorithm, const gchar *username, const gchar *realm, const gchar *password, const gchar *nonce, const gchar *client_nonce)
Calculates a session key for HTTP Digest authentation.
purple_cipher_context_encrypt
gint purple_cipher_context_encrypt(PurpleCipherContext *context, const guchar data[], size_t len, guchar output[], size_t *outlen)
Encrypts data using the context.
purple_cipher_context_new_by_name
PurpleCipherContext * purple_cipher_context_new_by_name(const gchar *name, void *extra)
Creates a new cipher context by the cipher name and initializes it.
purple_cipher_context_get_batch_mode
PurpleCipherBatchMode purple_cipher_context_get_batch_mode(PurpleCipherContext *context)
Gets the batch mode of a context.
purple_cipher_context_new
PurpleCipherContext * purple_cipher_context_new(PurpleCipher *cipher, void *extra)
Creates a new cipher context and initializes it.
purple_cipher_context_get_data
gpointer purple_cipher_context_get_data(PurpleCipherContext *context)
Gets the cipher data for a context.
purple_cipher_context_append
void purple_cipher_context_append(PurpleCipherContext *context, const guchar *data, size_t len)
Appends data to the context.
purple_cipher_get_name
const gchar * purple_cipher_get_name(PurpleCipher *cipher)
Gets a cipher's name.
PurpleCipherCaps
enum _PurpleCipherCaps PurpleCipherCaps
The operation flags for a cipher.
purple_cipher_context_digest
gboolean purple_cipher_context_digest(PurpleCipherContext *context, size_t in_len, guchar digest[], size_t *out_len)
Digests a context.
purple_ciphers_init
void purple_ciphers_init(void)
Initializes the cipher core.
PurpleCipher
struct _PurpleCipher PurpleCipher
A handle to a PurpleCipher.
Definition cipher.h:37
purple_cipher_context_set_option
void purple_cipher_context_set_option(PurpleCipherContext *context, const gchar *name, gpointer value)
Sets the value an option on a cipher context.
purple_ciphers_register_cipher
PurpleCipher * purple_ciphers_register_cipher(const gchar *name, PurpleCipherOps *ops)
Registers a cipher as a usable cipher.
purple_cipher_context_get_block_size
size_t purple_cipher_context_get_block_size(PurpleCipherContext *context)
Gets the block size of a context.
_PurpleCipherOps
The operations of a cipher.
Definition cipher.h:77
_PurpleCipherOps::set_option
void(* set_option)(PurpleCipherContext *context, const gchar *name, void *value)
The set option function.
Definition cipher.h:79
_PurpleCipherOps::decrypt
int(* decrypt)(PurpleCipherContext *context, const guchar data[], size_t len, guchar output[], size_t *outlen)
The decrypt function.
Definition cipher.h:106
_PurpleCipherOps::uninit
void(* uninit)(PurpleCipherContext *context)
The uninit function.
Definition cipher.h:91
_PurpleCipherOps::set_key
void(* set_key)(PurpleCipherContext *context, const guchar *key)
The set key function.
Definition cipher.h:115
_PurpleCipherOps::digest
gboolean(* digest)(PurpleCipherContext *context, size_t in_len, guchar digest[], size_t *out_len)
The digest function.
Definition cipher.h:100
_PurpleCipherOps::get_batch_mode
PurpleCipherBatchMode(* get_batch_mode)(PurpleCipherContext *context)
The get batch mode function.
Definition cipher.h:124
_PurpleCipherOps::reset
void(* reset)(PurpleCipherContext *context, void *extra)
The reset function.
Definition cipher.h:88
_PurpleCipherOps::get_salt_size
size_t(* get_salt_size)(PurpleCipherContext *context)
The get salt size function.
Definition cipher.h:112
_PurpleCipherOps::get_block_size
size_t(* get_block_size)(PurpleCipherContext *context)
The get block size function.
Definition cipher.h:127
_PurpleCipherOps::encrypt
int(* encrypt)(PurpleCipherContext *context, const guchar data[], size_t len, guchar output[], size_t *outlen)
The encrypt function.
Definition cipher.h:103
_PurpleCipherOps::get_key_size
size_t(* get_key_size)(PurpleCipherContext *context)
The get key size function.
Definition cipher.h:118
_PurpleCipherOps::append
void(* append)(PurpleCipherContext *context, const guchar *data, size_t len)
The append data function.
Definition cipher.h:97
_PurpleCipherOps::set_key_with_len
void(* set_key_with_len)(PurpleCipherContext *context, const guchar *key, size_t len)
The set key with length function.
Definition cipher.h:130
_PurpleCipherOps::set_batch_mode
void(* set_batch_mode)(PurpleCipherContext *context, PurpleCipherBatchMode mode)
The set batch mode function.
Definition cipher.h:121
_PurpleCipherOps::set_salt
void(* set_salt)(PurpleCipherContext *context, guchar *salt)
The set salt function.
Definition cipher.h:109
_PurpleCipherOps::set_iv
void(* set_iv)(PurpleCipherContext *context, guchar *iv, size_t len)
The set initialization vector function.
Definition cipher.h:94
_PurpleCipherOps::init
void(* init)(PurpleCipherContext *context, void *extra)
The init function.
Definition cipher.h:85