X-Git-Url: https://git.sommitrealweird.co.uk/onak.git/blobdiff_plain/4b8483ae278577a3adc8d84da81d77019704466f..2eed640f944a24204fa4ed0dbbc80004a800b1eb:/ll.h

diff --git a/ll.h b/ll.h
index 3890ca9..d4152cc 100644
--- a/ll.h
+++ b/ll.h
@@ -50,13 +50,26 @@ struct ll {
 struct ll *lladd(struct ll *curll, void *object);
 
 /**
+ *	lldel - Remove an item from a linked list.
+ *	@curll: The list to remove the item from.
+ *	@object: The object to remove.
+ *	@objectcmp: A pointer to a comparision function for the object type.
  *
+ *	Trawls through the list looking for the object. If it's found then it
+ *	is removed from the list. Only one occurance is searched for. Returns
+ *	a pointer to the head of the new list.
  */
 struct ll *lldel(struct ll *curll, void *object,
 	int (*objectcmp) (const void *object1, const void *object2));
 
 /**
+ *	llfind - Find an item in a linked list.
+ *	@curll: The list to look in.
+ *	@object: The object to look for.
+ *	@objectcmp: A pointer to a comparision function for the object type.
  *
+ *	Searches through a list for an object. Returns a pointer to the object
+ *	if it's found, otherwise NULL.
  */
 struct ll *llfind(struct ll *curll, void *object,
 	int (*objectcmp) (const void *object1, const void *object2));
@@ -69,4 +82,15 @@ struct ll *llfind(struct ll *curll, void *object,
  */
 unsigned long llsize(struct ll *curll);
 
+/**
+ *	llfree - Frees a linked list.
+ *	@curll: The list to free.
+ *	@objectfree: A pointer to a free function for the object.
+ *
+ * 	Walks through a list and free it. If a function is provided for
+ * 	objectfree then it's called for each element to free them, if it's NULL
+ * 	just the list is freed.
+ */
+void llfree(struct ll *curll, void (*objectfree) (void *object));
+
 #endif /* __LL_H__ */