* Jonathan McDowell <noodles@earth.li>
*
* Copyright 2002 Project Purple
- *
- * $Id: parsekey.h,v 1.4 2003/06/04 20:57:12 noodles Exp $
*/
#ifndef __PARSEKEY_H__
#include "keystructs.h"
-/**
- * add_key - Takes a key and adds it to the keyserver.
- * @key: The public key to add.
- *
- * This function takes a public key and adds it to the keyserver.
- * It first of all sees if we already have the key locally. If we do then
- * we retrieve it and merge the two keys. We then store the resulting key
- * (or just the original we received if we don't already have it). We then
- * send out the appropriate updates to our keyserver peers.
- */
-int add_key(struct openpgp_publickey *key);
-
/**
* parse_keys - Process a stream of packets for public keys + sigs.
* @packets: The packet list to parse.
* @getchar_func: The function to get the next character from the stream.
* @ctx: A pointer to the context structure for getchar_func.
* @packets: The outputted list of packets.
+ * @maxnum: The maximum number of keys to read. 0 means unlimited.
*
* This function uses getchar_func to read characters from an OpenPGP
* packet stream and reads the packets into a linked list of packets
- * ready for parsing as a public key or whatever.
+ * ready for parsing as a public key or whatever. maxnum allows you to
+ * specify the maximum number of keys to read. Note that if this is used
+ * then only the public key component of the last key will be returned,
+ * none of the other packets of the key will be read.
*/
int read_openpgp_stream(int (*getchar_func)(void *ctx, size_t count,
unsigned char *c),
void *ctx,
- struct openpgp_packet_list **packets);
+ struct openpgp_packet_list **packets,
+ int maxnum);
/**
* write_openpgp_stream - Reads a stream of OpenPGP packets.