1851. [doc] Doxygen comment markup. [RT #11398]

bin/named/unix/os.c

@@ -15,7 +15,9 @@
  * PERFORMANCE OF THIS SOFTWARE.
  */
 
-/* $Id: os.c,v 1.73 2005/04/07 03:49:58 marka Exp $ */
+/* $Id: os.c,v 1.74 2005/04/27 04:56:02 sra Exp $ */
+
+/*! \file */
 
 #include <config.h>
 #include <stdarg.h>
@@ -114,7 +116,7 @@ static int dfd[2] = { -1, -1 };
 static isc_boolean_t non_root = ISC_FALSE;
 static isc_boolean_t non_root_caps = ISC_FALSE;
 
-/*
+/*%
  * We define _LINUX_FS_H to prevent it from being included.  We don't need
  * anything from it, and the files it includes cause warnings with 2.2
  * kernels, and compilation failures (due to conflicts between <linux/string.h>
@@ -176,7 +178,7 @@ static void
 linux_initialprivs(void) {
 	unsigned int caps;
 
-	/*
+	/*%
 	 * We don't need most privileges, so we drop them right away.
 	 * Later on linux_minprivs() will be called, which will drop our
 	 * capabilities to the minimum needed to run the server.
@@ -231,7 +233,7 @@ static void
 linux_minprivs(void) {
 	unsigned int caps;
 
-	/*
+	/*%
 	 * Drop all privileges except the ability to bind() to privileged
 	 * ports.
 	 *
@@ -258,7 +260,7 @@ linux_minprivs(void) {
 static void
 linux_keepcaps(void) {
 	char strbuf[ISC_STRERRORSIZE];
-	/*
+	/*%
 	 * Ask the kernel to allow us to keep our capabilities after we
 	 * setuid().
 	 */