X-Git-Url: http://git.tuebingen.mpg.de/?p=adu.git;a=blobdiff_plain;f=adu.c;h=cd77fd9f9f4741b7c9f805072737bc4216f1f36e;hp=cbc42cb5769bc86b8e7c4ae214adaf781a63871e;hb=7c5fafb3a13d58cdfc96f90b74972f7d9f7adef1;hpb=63ef06be534ab9a8f31865ef6c2324f0a951aef9

diff --git a/adu.c b/adu.c
index cbc42cb..cd77fd9 100644
--- a/adu.c
+++ b/adu.c
@@ -1,4 +1,10 @@
-/** \file adu.c The main functions used by all modes of operation. */
+/*
+ * Copyright (C) 2008 Andre Noll <maan@systemlinux.org>
+ *
+ * Licensed under the GPL v2. For licencing details see COPYING.
+ */
+
+/** \file adu.c \brief The main functions used by all modes of operation. */
 #include "adu.h"
 #include <dirent.h> /* readdir() */
 #include <pwd.h>
@@ -12,6 +18,12 @@
 #include "error.h"
 
 DEFINE_ERRLIST;
+
+/**
+ * The error code of the last osl library function.
+ *
+ * \sa osl().
+ */
 int osl_errno;
 
 /** In case a signal is received, its number is stored here. */
@@ -114,7 +126,7 @@ static void close_dir_table(void)
 	dir_table = NULL;
 }
 
-void close_all_tables(void)
+static void close_all_tables(void)
 {
 	close_dir_table();
 	close_user_tables();
@@ -125,6 +137,12 @@ static void signal_handler(int s)
 	signum = s;
 }
 
+/**
+ * Check whether to terminate adu.
+ *
+ * Check whether a signal was caught that should terminate the
+ * adu process. If yes, close all osl tables and exit gracefully.
+ */
 void check_signals(void)
 {
 	if (likely(!signum))
@@ -145,6 +163,13 @@ static int init_signals(void)
 	return 1;
 }
 
+/**
+ * Open the directory table.
+ *
+ * \param create If non-zero, create the table first.
+ *
+ * \return Standard.
+ */
 int open_dir_table(int create)
 {
 
@@ -215,6 +240,17 @@ static int print_complete_help_and_die(void)
 	exit(EXIT_FAILURE);
 }
 
+/**
+ * The main function of adu.
+ *
+ * \param argc Usual argument count.
+ * \param argv Usual argument vector.
+ *
+ * Check command line options, init the signal handlers and
+ * call the main function of the selected mode.
+ *
+ * \return \p EXIT_SUCCESS on success, \p EXIT_FAILURE otherwise.
+ */
 int main(int argc, char **argv)
 {
 	int ret;