X-Git-Url: http://the.earth.li/gitweb/?a=blobdiff_plain;f=decodekey.h;h=8d6306aeb2ac144086fb960a0122a23dcd87b05e;hb=23f086c85c5d2db35e9ce76cf0bbf72200b4dc42;hp=57bf68074a66c28926463db2e9cc284904d27ecf;hpb=394938c479925750ffe56c28d281945ba4003a14;p=onak.git

diff --git a/decodekey.h b/decodekey.h
index 57bf680..8d6306a 100644
--- a/decodekey.h
+++ b/decodekey.h
@@ -1,14 +1,27 @@
 /*
  * keyindex.h - Routines to list an OpenPGP key.
  *
- * Jonathan McDowell <noodles@earth.li>
+ * Copyright 2002-2008 Jonathan McDowell <noodles@earth.li>
  *
- * Copyright 2002 Project Purple
+ * 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; version 2 of the License.
+ *
+ * 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 02110-1301, USA.
  */
 
 #ifndef __DECODEKEY_H__
 #define __DECODEKEY_H__
 
+#include <inttypes.h>
+#include <time.h>
 #include "keystructs.h"
 #include "ll.h"
 
@@ -23,6 +36,18 @@
 struct ll *keysigs(struct ll *curll,
 		struct openpgp_packet_list *sigs);
 
+/**
+ *	sig_info - Get info on a given OpenPGP signature packet
+ *	@packet: The signature packet
+ *	@keyid: A pointer for where to return the signature keyid
+ *	@creation: A pointer for where to return the signature creation time
+ *
+ *	Gets any info about a signature packet; parses the subpackets for a v4
+ *	key or pulls the data directly from v2/3. NULL can be passed for any
+ *	values which aren't cared about.
+ */
+void sig_info(struct openpgp_packet *packet, uint64_t *keyid, time_t *creation);
+
 /**
  *	sig_keyid - Return the keyid for a given OpenPGP signature packet.
  *	@packet: The signature packet.
@@ -43,12 +68,25 @@ uint64_t sig_keyid(struct openpgp_packet *packet);
 char **keyuids(struct openpgp_publickey *key, char **primary);
 
 /**
- *	keysubkeys - Takes a key and returns an array of its subkey keyids.
+ *	keysubkeys - Takes a key & returns an array of its subkey fingerprints
  *	@key: The key to get the subkeys of.
  *
  *	keysubkeys takes a public key structure and returns an array of the
- *	subkey keyids for that key.
+ *	subkey fingerprints for that key.
+ */
+struct openpgp_fingerprint *keysubkeys(struct openpgp_publickey *key);
+
+/**
+ *	parse_subpackets - Parse the subpackets of a Type 4 signature.
+ *	@data: The subpacket data.
+ *	@keyid: A pointer to where we should return the keyid.
+ *	@creationtime: A pointer to where we should return the creation time.
+ *
+ *	This function parses the subkey data of a Type 4 signature and fills
+ *	in the supplied variables. It also returns the length of the data
+ *	processed. If the value of any piece of data is not desired a NULL
+ *	can be passed instead of a pointer to a storage area for that value.
  */
-uint64_t *keysubkeys(struct openpgp_publickey *key);
+int parse_subpackets(unsigned char *data, uint64_t *keyid, time_t *creation);
 
 #endif