Clean up "set but not used" GCC warnings

[onak.git] / keyid.h

diff --git a/keyid.h b/keyid.h
index 8a360568aae194b4f964f369937825cf1f8803ab..d6e48e6ceb1d54ca6f2a0b511464dc8db54ef0d5 100644 (file)
--- a/keyid.h
+++ b/keyid.h
@@ -1,17 +1,25 @@
 /*
  * keyid.h - Routines to calculate key IDs.
  *
- * Jonathan McDowell <noodles@earth.li>
+ * Copyright 2002,2011 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.
  *
- * $Id: keyid.h,v 1.4 2003/06/04 20:57:09 noodles Exp $
+ * 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 __KEYID_H__
 #define __KEYID_H__
 
-// #include <stdint.h>
 #include <inttypes.h>
 
 #include "keystructs.h"
@@ -46,4 +54,28 @@ unsigned char *get_fingerprint(struct openpgp_packet *packet,
  */
 uint64_t get_packetid(struct openpgp_packet *packet);
 
+/**
+ *     get_skshash - Given a public key returns the SKS hash for it.
+ *     @publickey: The key to calculate the hash for.
+ *     @skshash: Hash structure to sort the result in.
+ *
+ *     This function returns the SKS hash for a given public key. This
+ *     is an MD5 hash over a sorted list of all of the packets that
+ *     make up the key. The caller should allocate the memory for the
+ *     hash.
+ */
+void get_skshash(struct openpgp_publickey *publickey, struct skshash *hash);
+
+/**
+ *     parse_skshash - Parse a string into an SKS hash structure.
+ *     @search: The string representing the SKS hash.
+ *     @hash: A pointer to the structure to store the hash in.
+ *
+ *     Takes a string and tries to parse it as an SKS hash hex
+ *     representation. Puts the hash into the supplied structure
+ *     if successful. Returns 1 if we parsed something ok, 0 if
+ *     we failed.
+ */
+int parse_skshash(char *search, struct skshash *hash);
+
 #endif /* __KEYID_H__ */