g_mime_cipher_context_hash_id ()

GMimeCipherHash
g_mime_cipher_context_hash_id (GMimeCipherContext *ctx,
                               const char *hash);

Gets the hash id based on the hash name hash .

g_mime_cipher_context_hash_name ()

const char *
g_mime_cipher_context_hash_name (GMimeCipherContext *ctx,
                                 GMimeCipherHash hash);

Gets the hash name based on the hash id hash .

g_mime_cipher_context_sign ()

int
g_mime_cipher_context_sign (GMimeCipherContext *ctx,
                            const char *userid,
                            GMimeCipherHash hash,
                            GMimeStream *istream,
                            GMimeStream *ostream,
                            GError **err);

Signs the input stream and writes the resulting signature to the output stream.

g_mime_cipher_context_verify ()

GMimeSignatureValidity *
g_mime_cipher_context_verify (GMimeCipherContext *ctx,
                              GMimeCipherHash hash,
                              GMimeStream *istream,
                              GMimeStream *sigstream,
                              GError **err);

Verifies the signature. If istream is a clearsigned stream, you should pass NULL as the sigstream parameter. Otherwise sigstream is assumed to be the signature stream and is used to verify the integirity of the istream .

g_mime_cipher_context_encrypt ()

int
g_mime_cipher_context_encrypt (GMimeCipherContext *ctx,
                               gboolean sign,
                               const char *userid,
                               GPtrArray *recipients,
                               GMimeStream *istream,
                               GMimeStream *ostream,
                               GError **err);

Encrypts (and optionally signs) the cleartext input stream and writes the resulting ciphertext to the output stream.

g_mime_cipher_context_decrypt ()

GMimeSignatureValidity *
g_mime_cipher_context_decrypt (GMimeCipherContext *ctx,
                               GMimeStream *istream,
                               GMimeStream *ostream,
                               GError **err);

Decrypts the ciphertext input stream and writes the resulting cleartext to the output stream.

If the encrypted input stream was also signed, the returned GMimeSignatureValidity will have signer information included and the signature status will be one of GMIME_SIGNATURE_STATUS_GOOD, GMIME_SIGNATURE_STATUS_BAD, or GMIME_SIGNATURE_STATUS_UNKNOWN.

If the encrypted input text was not signed, then the signature status of the returned GMimeSignatureValidity will be GMIME_SIGNATURE_STATUS_NONE.

g_mime_cipher_context_import_keys ()

int
g_mime_cipher_context_import_keys (GMimeCipherContext *ctx,
                                   GMimeStream *istream,
                                   GError **err);

Imports a stream of keys/certificates contained within istream into the key/certificate database controlled by ctx .

g_mime_cipher_context_export_keys ()

int
g_mime_cipher_context_export_keys (GMimeCipherContext *ctx,
                                   GPtrArray *keys,
                                   GMimeStream *ostream,
                                   GError **err);

Exports the keys/certificates in keys to the stream ostream from the key/certificate database controlled by ctx .

g_mime_signer_new ()

GMimeSigner *
g_mime_signer_new (void);

Allocates an new GMimeSigner.

g_mime_signer_free ()

void
g_mime_signer_free (GMimeSigner *signer);

Frees a singleton signer. Should NOT be used to free signers returned from g_mime_signature_validity_get_signers().

g_mime_signer_next ()

GMimeSigner *
g_mime_signer_next (GMimeSigner *signer);

Advance to the next signer.

g_mime_signer_get_status ()

GMimeSignerStatus
g_mime_signer_get_status (const GMimeSigner *signer);

Get the signer status.

g_mime_signer_set_status ()

void
g_mime_signer_set_status (GMimeSigner *signer,
                          GMimeSignerStatus status);

Set the status on the signer.

g_mime_signer_get_errors ()

GMimeSignerError
g_mime_signer_get_errors (const GMimeSigner *signer);

Get the signer errors.

g_mime_signer_set_errors ()

void
g_mime_signer_set_errors (GMimeSigner *signer,
                          GMimeSignerError error);

Set the errors on the signer.

g_mime_signer_get_trust ()

GMimeSignerTrust
g_mime_signer_get_trust (const GMimeSigner *signer);

Get the signer trust.

g_mime_signer_set_trust ()

void
g_mime_signer_set_trust (GMimeSigner *signer,
                         GMimeSignerTrust trust);

Set the signer trust.

g_mime_signer_get_fingerprint ()

const char *
g_mime_signer_get_fingerprint (const GMimeSigner *signer);

Get the signer's key fingerprint.

g_mime_signer_set_fingerprint ()

void
g_mime_signer_set_fingerprint (GMimeSigner *signer,
                               const char *fingerprint);

Set the signer's key fingerprint.

g_mime_signer_get_key_id ()

const char *
g_mime_signer_get_key_id (const GMimeSigner *signer);

Get the signer's key id.

g_mime_signer_set_key_id ()

void
g_mime_signer_set_key_id (GMimeSigner *signer,
                          const char *key_id);

Set the signer's key id.

g_mime_signer_get_name ()

const char *
g_mime_signer_get_name (const GMimeSigner *signer);

Get the signer's name.

g_mime_signer_set_name ()

void
g_mime_signer_set_name (GMimeSigner *signer,
                        const char *name);

Set the signer's name.

g_mime_signer_get_created ()

time_t
g_mime_signer_get_created (const GMimeSigner *signer);

Get the creation date of the signer's key.

g_mime_signer_set_created ()

void
g_mime_signer_set_created (GMimeSigner *signer,
                           time_t created);

Set the signer's key creation date.

g_mime_signer_get_expires ()

time_t
g_mime_signer_get_expires (const GMimeSigner *signer);

Get the expiration date of the signer's key.

g_mime_signer_set_expires ()

void
g_mime_signer_set_expires (GMimeSigner *signer,
                           time_t expires);

Set the signer's key expiration date.

g_mime_signature_validity_new ()

GMimeSignatureValidity *
g_mime_signature_validity_new (void);

Creates a new GMimeSignatureValidity.

g_mime_signature_validity_free ()

void
g_mime_signature_validity_free (GMimeSignatureValidity *validity);

Frees the memory used by validity back to the system.

g_mime_signature_validity_set_status ()

void
g_mime_signature_validity_set_status (GMimeSignatureValidity *validity,
                                      GMimeSignatureStatus status);

Sets the status of the signature on validity .

g_mime_signature_validity_get_status ()

GMimeSignatureStatus
g_mime_signature_validity_get_status (const GMimeSignatureValidity *validity);

Gets the signature status (GOOD, BAD, UNKNOWN).

g_mime_signature_validity_set_details ()

void
g_mime_signature_validity_set_details (GMimeSignatureValidity *validity,
                                       const char *details);

Sets details as the status details string on validity .

g_mime_signature_validity_get_details ()

const char *
g_mime_signature_validity_get_details (const GMimeSignatureValidity *validity);

Gets any user-readable status details.

g_mime_signature_validity_add_signer ()

void
g_mime_signature_validity_add_signer (GMimeSignatureValidity *validity,
                                      GMimeSigner *signer);

Adds signer to the list of signers on validity . Once the signer is added, it must NOT be freed.

g_mime_signature_validity_get_signers ()

const GMimeSigner *
g_mime_signature_validity_get_signers (const GMimeSignatureValidity *validity);

Gets the list of signers.

enum GMimeCipherHash

A hash algorithm.

struct GMimeCipherContext

struct GMimeCipherContext;

A crypto context for use with MIME.

struct GMimeSignatureValidity

struct GMimeSignatureValidity {
	GMimeSignatureStatus status;
	GMimeSigner *signers;
	char *details;
};

A structure containing information about the signature validity of a signed stream.

enum GMimeSignatureStatus

The status of a message signature.

enum GMimeSignerStatus

A value representing the signature status for a particular GMimeSigner.

enum GMimeSignerTrust

The trust value of a signer.

enum GMimeSignerError

Possible errors that a GMimeSigner could have.

struct GMimeSigner

struct GMimeSigner {
	GMimeSigner *next;
	unsigned int status:2;    /* GMimeSignerStatus */
	unsigned int errors:4;    /* bitfield of GMimeSignerError's */
	unsigned int trust:3;     /* GMimeSignerTrust */
	unsigned int unused:23;   /* unused expansion bits */
	char *fingerprint;
	time_t created;
	time_t expires;
	char *keyid;
	char *name;
};

A structure containing useful information about a signer.