factorial: Fix usage message to fit in with conventions.

[u/mdw/catacomb] / des.h

diff --git a/des.h b/des.h
index b24037b..489d5e0 100644 (file)
--- a/des.h
+++ b/des.h
@@ -1,6 +1,6 @@
 /* -*-c-*-
  *
- * $Id: des.h,v 1.4 2004/04/08 01:36:15 mdw Exp $
+ * $Id$
  *
  * The Data Encryption Standard
  *
@@ -68,6 +68,22 @@ typedef struct des_ctx {
 
 /*----- Functions provided ------------------------------------------------*/
 
+/* --- @des_expand@ --- *
+ *
+ * Arguments:  @const octet *k@ = pointer to key material
+ *             @size_t n@ = number of octets of key material (7 or 8)
+ *             @uint32 *xx, *yy@ = where to put the results
+ *
+ * Returns:    ---
+ *
+ * Use:                Extracts 64 bits of key material from the given buffer,
+ *             possibly expanding it from 56 to 64 bits on the way.
+ *             Parity is set correctly if the key is expanded.
+ */
+
+extern void des_expand(const octet */*k*/, size_t /*n*/,
+                      uint32 */*xx*/, uint32 */*yy*/);
+
 /* --- @des_init@ --- *
  *
  * Arguments:  @des_ctx *k@ = pointer to key block