1 files changed, 34 insertions, 6 deletions
diff --git a/src/common/protocol_private.h b/src/common/protocol_private.h
index 3a4b1b2..653d19c 100644
--- a/src/common/protocol_private.h
+++ b/src/common/protocol_private.h
@@ -18,10 +18,12 @@
  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  */
 
-#ifdef PROTOCOL_H_PRIVATE
+#ifndef PROTOCOL_H_PRIVATE
 #define PROTOCOL_H_PRIVATE
 
-#define TLV_ARR_SIZE	(16)
+#include "utils.h"
+
+#define TLV_BUF_SIZE	(16)
 
 /* Pease don't rape the buffer with long messages, daemon-kun. */
 #define MSG_BUF_SIZE	(257)
@@ -38,10 +40,22 @@
  * */
 size_t tlv_count(const struct packet_data * const packet);
 
-/* Parses a data packet, fills buffer of tlv's of size `buf_size` and returns
- * the number of tlv's actually parsed.
+
+/**
+ * Parses tlv's from packet data and writes them to a buffer of given size.
+ * 
+ * Returns how many tlv's were actually parsed.
  *
  * To check for errors, set errno to 0 and check after calling.
+ *  
+ * Not yet implemented.
+ * 
+ * @param data Data from network packet
+ * @param buf Buffer to store parsed tlv's
+ * @param buf_size Size of buffer used to store tlv's
+ * 
+ * @return Number of tlv's actually parsed. Greter than or equal to buffer
+ * size, if an error occurs.
  * */
 size_t get_tlvs(	const struct packet_data * const data,
 			const struct tlv *buf,
@@ -51,16 +65,30 @@ size_t get_tlvs(	const struct packet_data * const data,
  * */
 void push_string(char *str);
 
-void push_fpi1(fpi1_t num);
+/* Reinterprets char * as fpi1_t * and appends it to the outgoing packet as a
+ * tlv.
+ */
+void push_fpi1(char *num);
 
+/* Reinterprets char * as time_t * and appends it to the outgoing packet as a
+ * tlv.
+ */
 void push_timestamp(char *data);
 
+/* Not implemented yet. */
 void push_request(char *data);
 
+/* Not implemented yet. */
 void push_reply(char *data);
 
+/* Reinterprets char * as uuid_t * and appends it to the outgoing packet as a
+ * tlv.
+ */
 void push_uuid(char *data);
 
-
+/* Appends tlv_type and size of data to a packet effectively creating a tlv
+ * header.
+ */
+void push_tlv_header(enum tlv_type type, size_t size);
 
 #endif /* PROTOCOL_H_PRIVATE */