0.6.2 release

[onak.git] / keyid.h

diff --git a/keyid.h b/keyid.h
index a0ae4ffe916bcd1bf28395f5127dc91eb3ae9897..5bf4c2da991af984e43106b6dd9073bba8d8c4a5 100644 (file)
--- a/keyid.h
+++ b/keyid.h
@@ -13,8 +13,7 @@
  * 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.
+ * this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
 #ifndef __KEYID_H__
@@ -25,6 +24,16 @@
 #include "keystructs.h"
 #include "onak.h"
 
+/**
+ *     fingerprint2keyid - convert a fingerprint to a keyid
+ *     @fingerprint: The fingerprint structure to convert
+ *     @returns: 64 bit keyid
+ *
+ *     This function returns the key id for a given fingerprint. Currently
+ *     only works for v4 fingerprints.
+ */
+uint64_t fingerprint2keyid(struct openpgp_fingerprint *fingerprint);
+
 /**
  *     get_keyid - Given a public key returns the keyid.
  *     @publickey: The key to calculate the id for.
@@ -37,16 +46,14 @@ onak_status_t get_keyid(struct openpgp_publickey *publickey, uint64_t *keyid);
 /**
  *     get_fingerprint - Given a public key returns the fingerprint.
  *     @publickey: The key to calculate the id for.
- *     @fingerprint: The fingerprint (must be at least 20 bytes of space).
- *     @len: The length of the returned fingerprint.
+ *     @fingerprint: The fingerprint structure to store the result in
  *
  *     This function returns the fingerprint for a given public key. As Type 3
  *     fingerprints are 16 bytes and Type 4 are 20 the len field indicates
  *     which we've returned.
  */
 onak_status_t get_fingerprint(struct openpgp_packet *packet,
-       unsigned char *fingerprint,
-       size_t *len);
+       struct openpgp_fingerprint *fingerprint);
 
 /**
  *     get_packetid - Given a PGP packet returns the keyid.