X-Git-Url: https://git.distorted.org.uk/u/mdw/catacomb/blobdiff_plain/1dda051bbae15d2f45db44e1828056b3f2e97285..6ec3a4cf4aaa7cd375e1aa18f85861986259b8e5:/key.h

diff --git a/key.h b/key.h
index aad448b..dffd0eb 100644
--- a/key.h
+++ b/key.h
@@ -7,7 +7,7 @@
  * (c) 1999 Straylight/Edgeware
  */
 
-/*----- Licensing notice --------------------------------------------------* 
+/*----- Licensing notice --------------------------------------------------*
  *
  * This file is part of Catacomb.
  *
@@ -15,12 +15,12 @@
  * it under the terms of the GNU Library General Public License as
  * published by the Free Software Foundation; either version 2 of the
  * License, or (at your option) any later version.
- * 
+ *
  * Catacomb 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 Library General Public License for more details.
- * 
+ *
  * You should have received a copy of the GNU Library General Public
  * License along with Catacomb; if not, write to the Free
  * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
@@ -84,7 +84,7 @@ typedef struct key_attr {
 typedef struct key {
 
   /* --- Hashtable management --- */
-  
+
   hash_base _b;				/* Symbol table data */
   struct key *next;			/* Next key of the same type */
 
@@ -97,7 +97,7 @@ typedef struct key {
 
   /* --- The key data itself --- */
 
-  key_data k;				/* The actual key data */
+  key_data *k;				/* The actual key data */
 
   /* --- Other attributes and commentary --- */
 
@@ -240,7 +240,7 @@ extern int key_open(key_file */*f*/, const char */*file*/, unsigned /*how*/,
  * Use:		Frees all the key data, without writing changes.
  */
 
-extern int key_discard(key_file */*f*/);
+extern void key_discard(key_file */*f*/);
 
 /* --- @key_close@ --- *
  *
@@ -302,10 +302,9 @@ extern int key_lockfile(key_file */*f*/, const char */*file*/,
  *		@uint32 id@ = keyid to set
  *		@const char *type@ = the type of this key
  *		@time_t exp@ = when the key expires
- *		@int *err@ = where to store the error condition
+ *		@key *kk@ = where to put the key pointer
  *
- * Returns:	Key block containing new data, or null if it couldn't be
- *		done.
+ * Returns:	Error code (one of the @KERR@ constants).
  *
  * Use:		Attaches a new key to a key file.  You must have a writable
  *		key file for this to work.
@@ -324,8 +323,8 @@ extern int key_lockfile(key_file */*f*/, const char */*file*/,
  *		You have to set the actual key yourself.
  */
 
-extern key *key_new(key_file */*f*/, uint32 /*id*/, const char */*type*/,
-		    time_t /*exp*/, int */*err*/);
+extern int key_new(key_file */*f*/, uint32 /*id*/, const char */*type*/,
+		   time_t /*exp*/, key **/*kk*/);
 
 /* --- @key_delete@ --- *
  *
@@ -451,6 +450,19 @@ extern int key_setcomment(key_file */*f*/, key */*k*/, const char */*c*/);
 
 extern int key_settag(key_file */*f*/, key */*k*/, const char */*tag*/);
 
+/* --- @key_setkeydata@ --- *
+ *
+ * Arguments:	@key_file *kf@ = pointer to key file
+ *		@key *k@ = pointer to key
+ *		@key_data *kd@ = new key data
+ *
+ * Returns:	Zero on success, or a @KERR_@ error code on failure.
+ *
+ * Use:		Sets the key data for a key.
+ */
+
+extern int key_setkeydata(key_file */*kf*/, key */*k*/, key_data */*kd*/);
+
 /* --- @key_fulltag@ --- *
  *
  * Arguments:	@key *k@ = pointer to key
@@ -471,7 +483,7 @@ extern void key_fulltag(key */*k*/, dstr */*d*/);
  *		@const char *tag@ = pointer to tag string
  *		@dstr *d@ = pointer to string for full tag name
  *		@key **k@ = where to store the key pointer
- *		@key_data **kd@ = where to store the key data pointer
+ *		@key_data ***kd@ = where to store the key data pointer
  *
  * Returns:	Zero if OK, nonzero if it failed.
  *
@@ -479,11 +491,11 @@ extern void key_fulltag(key */*k*/, dstr */*d*/);
  *		qualified by the names of subkeys, separated by dots.  Hence,
  *		a qualified tag is ID|TAG[.TAG...].  The various result
  *		pointers can be null to indicate that the result isn't
- *		interesting. 
+ *		interesting.
  */
 
 extern int key_qtag(key_file */*f*/, const char */*tag*/,
-		    dstr */*d*/, key **/*k*/, key_data **/*kd*/);
+		    dstr */*d*/, key **/*k*/, key_data ***/*kd*/);
 
 /* --- @key_getattr@ --- *
  *