Table of Contents

1. Introduction

1.1 Getting Started
1.2 Features
1.3 Overview

2. Preparation

2.1 Header
2.2 Building the Source
2.3 Using Automake
2.4 Library Version Check
2.5 Multi Threading

3. Protocols and Engines

3.1 Engine Version Check
3.2 Engine Information
3.3 OpenPGP
3.4 Cryptographic Message Syntax

4. Error Handling

4.1 Error Values
4.2 Error Strings

5. Exchanging Data

5.1 Creating Data Buffers
5.2 Destroying Data Buffers
5.3 Manipulating Data Buffers

6. Contexts

6.1 Creating Contexts
6.2 Destroying Contexts
6.3 Context Attributes

6.3.1 Protocol Selection
6.3.2 ASCII Armor
6.3.3 Text Mode
6.3.4 Included Certificates
6.3.5 Key Listing Mode
6.3.6 Passphrase Callback
6.3.7 Progress Meter Callback

6.4 Key Management

6.4.1 Listing Keys
6.4.2 Information About Keys
6.4.3 Manipulating Keys
6.4.4 Generating Keys
6.4.5 Exporting Keys
6.4.6 Importing Keys
6.4.7 Deleting Keys

6.5 Trust Item Management

6.5.1 Listing Trust Items
6.5.2 Information About Trust Items
6.5.3 Manipulating Trust Items

6.6 Crypto Operations

6.6.1 Decrypt
6.6.2 Verify
6.6.3 Decrypt and Verify
6.6.4 Sign

6.6.4.1 Selecting Signers
6.6.4.2 Creating a Signature

6.6.5 Encrypt

6.6.5.1 Selecting Recipients
6.6.5.2 Encrypting a Plaintext

6.6.6 Detailed Results

6.7 Run Control

6.7.1 Waiting For Completion
6.7.2 Cancelling an Operation
6.7.3 Hooking Up Into Idle Time
6.7.4 Using External Event Loops

6.7.4.1 I/O Callback Interface
6.7.4.2 Registering I/O Callbacks
6.7.4.3 I/O Callback Example
6.7.4.4 I/O Callback Example GTK+
6.7.4.5 I/O Callback Example GDK

A. GNU GENERAL PUBLIC LICENSE

A.0.1 Preamble

How to Apply These Terms to Your New Programs

B. GNU Free Documentation License

B.0.1 ADDENDUM: How to use this License for your documents

Concept Index
Function and Data Index