X-Git-Url: https://git.enpas.org/?a=blobdiff_plain;f=include%2Flibelfu%2Felfops.h;fp=include%2Flibelfu%2Felfops.h;h=dde51bcd9993c7904cd11392164131393b059a63;hb=50b85e44529f195bf8156e9c0045d8b017ee26f5;hp=4131f410967a96e82fb449b03171cbf81205ddc9;hpb=28507233568a6deb80e243bd82df1e93f0b136a0;p=centaur.git

diff --git a/include/libelfu/elfops.h b/include/libelfu/elfops.h
index 4131f41..dde51bc 100644
--- a/include/libelfu/elfops.h
+++ b/include/libelfu/elfops.h
@@ -1,3 +1,12 @@
+/*!
+ * @file elfops.h
+ * @brief Operations offered by libelfu on libelf handles
+ *
+ * This includes:
+ *  - Checks
+ *  - Post-processing for ELF specification compliance
+ */
+
 #ifndef __LIBELFU_ELFOPS_H_
 #define __LIBELFU_ELFOPS_H_
 
@@ -7,7 +16,22 @@
 #include <libelfu/types.h>
 
 
+/*!
+ * @brief Perform a large array of sanity checks.
+ * @param e libelf handle to file to be checked.
+ * @result 0 if successful.
+ *         Anything else indicates an error.
+ * @note If a file does not pass these checks,
+ *       then it cannot be processed by libelfu.
+ */
 int elfu_eCheck(Elf *e);
+
+
+
+/*!
+ * @brief Reorder PHDRs to comply with ELF specification.
+ * @param e libelf handle to file to be post-processed.
+ */
 void elfu_eReorderPhdrs(Elf *e);