diff options
author | Christian Grothoff <christian@grothoff.org> | 2013-08-21 15:16:58 +0000 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2013-08-21 15:16:58 +0000 |
commit | 5a38c8f0d1826ea964e3e3452e1a3a2a24d7d35b (patch) | |
tree | 7ba261fc1882bcfa6dc0da916272a0ed0d17468e /src/include/gnunet_service_lib.h | |
parent | 1fca0c918c8468ba16666e8a1c41526cacdc6df2 (diff) | |
download | gnunet-5a38c8f0d1826ea964e3e3452e1a3a2a24d7d35b.tar.gz gnunet-5a38c8f0d1826ea964e3e3452e1a3a2a24d7d35b.zip |
-misc doxygen fixes
Diffstat (limited to 'src/include/gnunet_service_lib.h')
-rw-r--r-- | src/include/gnunet_service_lib.h | 40 |
1 files changed, 24 insertions, 16 deletions
diff --git a/src/include/gnunet_service_lib.h b/src/include/gnunet_service_lib.h index cc224ff16..2d7b3064f 100644 --- a/src/include/gnunet_service_lib.h +++ b/src/include/gnunet_service_lib.h | |||
@@ -1,10 +1,10 @@ | |||
1 | /* | 1 | /* |
2 | This file is part of GNUnet. | 2 | This file is part of GNUnet. |
3 | (C) 2009 Christian Grothoff (and other contributing authors) | 3 | (C) 2009-2013 Christian Grothoff (and other contributing authors) |
4 | 4 | ||
5 | GNUnet is free software; you can redistribute it and/or modify | 5 | GNUnet is free software; you can redistribute it and/or modify |
6 | it under the terms of the GNU General Public License as published | 6 | it under the terms of the GNU General Public License as published |
7 | by the Free Software Foundation; either version 2, or (at your | 7 | by the Free Software Foundation; either version 3, or (at your |
8 | option) any later version. | 8 | option) any later version. |
9 | 9 | ||
10 | GNUnet is distributed in the hope that it will be useful, but | 10 | GNUnet is distributed in the hope that it will be useful, but |
@@ -22,6 +22,8 @@ | |||
22 | * @file include/gnunet_service_lib.h | 22 | * @file include/gnunet_service_lib.h |
23 | * @brief functions related to starting services | 23 | * @brief functions related to starting services |
24 | * @author Christian Grothoff | 24 | * @author Christian Grothoff |
25 | * @defgroup service generic functions for implementing service processes | ||
26 | * @{ | ||
25 | */ | 27 | */ |
26 | 28 | ||
27 | #ifndef GNUNET_SERVICE_LIB_H | 29 | #ifndef GNUNET_SERVICE_LIB_H |
@@ -49,21 +51,21 @@ extern "C" | |||
49 | * addresses the server should bind to and listen on; the | 51 | * addresses the server should bind to and listen on; the |
50 | * array will be NULL-terminated (on success) | 52 | * array will be NULL-terminated (on success) |
51 | * @param addr_lens set (call by reference) to an array of the lengths | 53 | * @param addr_lens set (call by reference) to an array of the lengths |
52 | * of the respective 'struct sockaddr' struct in the 'addrs' | 54 | * of the respective 'struct sockaddr' struct in the @a addrs |
53 | * array (on success) | 55 | * array (on success) |
54 | * @return number of addresses found on success, | 56 | * @return number of addresses found on success, |
55 | * GNUNET_SYSERR if the configuration | 57 | * #GNUNET_SYSERR if the configuration |
56 | * did not specify reasonable finding information or | 58 | * did not specify reasonable finding information or |
57 | * if it specified a hostname that could not be resolved; | 59 | * if it specified a hostname that could not be resolved; |
58 | * GNUNET_NO if the number of addresses configured is | 60 | * #GNUNET_NO if the number of addresses configured is |
59 | * zero (in this case, '*addrs' and '*addr_lens' will be | 61 | * zero (in this case, '* @a addrs' and '* @a addr_lens' will be |
60 | * set to NULL). | 62 | * set to NULL). |
61 | */ | 63 | */ |
62 | int | 64 | int |
63 | GNUNET_SERVICE_get_server_addresses (const char *service_name, | 65 | GNUNET_SERVICE_get_server_addresses (const char *service_name, |
64 | const struct GNUNET_CONFIGURATION_Handle | 66 | const struct GNUNET_CONFIGURATION_Handle |
65 | *cfg, struct sockaddr ***addrs, | 67 | *cfg, struct sockaddr ***addrs, |
66 | socklen_t ** addr_lens); | 68 | socklen_t **addr_lens); |
67 | 69 | ||
68 | 70 | ||
69 | /** | 71 | /** |
@@ -75,9 +77,8 @@ GNUNET_SERVICE_get_server_addresses (const char *service_name, | |||
75 | * @param cfg configuration to use | 77 | * @param cfg configuration to use |
76 | */ | 78 | */ |
77 | typedef void (*GNUNET_SERVICE_Main) (void *cls, | 79 | typedef void (*GNUNET_SERVICE_Main) (void *cls, |
78 | struct GNUNET_SERVER_Handle * server, | 80 | struct GNUNET_SERVER_Handle *server, |
79 | const struct GNUNET_CONFIGURATION_Handle * | 81 | const struct GNUNET_CONFIGURATION_Handle *cfg); |
80 | cfg); | ||
81 | 82 | ||
82 | 83 | ||
83 | /** | 84 | /** |
@@ -108,19 +109,21 @@ enum GNUNET_SERVICE_Options | |||
108 | * Run a standard GNUnet service startup sequence (initialize loggers | 109 | * Run a standard GNUnet service startup sequence (initialize loggers |
109 | * and configuration, parse options). | 110 | * and configuration, parse options). |
110 | * | 111 | * |
111 | * @param argc number of command line arguments | 112 | * @param argc number of command line arguments in @a argv |
112 | * @param argv command line arguments | 113 | * @param argv command line arguments |
113 | * @param service_name our service name | 114 | * @param service_name our service name |
114 | * @param options service options | 115 | * @param options service options |
115 | * @param task main task of the service | 116 | * @param task main task of the service |
116 | * @param task_cls closure for task | 117 | * @param task_cls closure for @a task |
117 | * @return GNUNET_SYSERR on error, GNUNET_OK | 118 | * @return #GNUNET_SYSERR on error, #GNUNET_OK |
118 | * if we shutdown nicely | 119 | * if we shutdown nicely |
119 | */ | 120 | */ |
120 | int | 121 | int |
121 | GNUNET_SERVICE_run (int argc, char *const *argv, const char *service_name, | 122 | GNUNET_SERVICE_run (int argc, char *const *argv, |
123 | const char *service_name, | ||
122 | enum GNUNET_SERVICE_Options options, | 124 | enum GNUNET_SERVICE_Options options, |
123 | GNUNET_SERVICE_Main task, void *task_cls); | 125 | GNUNET_SERVICE_Main task, |
126 | void *task_cls); | ||
124 | 127 | ||
125 | 128 | ||
126 | /** | 129 | /** |
@@ -128,6 +131,7 @@ GNUNET_SERVICE_run (int argc, char *const *argv, const char *service_name, | |||
128 | */ | 131 | */ |
129 | struct GNUNET_SERVICE_Context; | 132 | struct GNUNET_SERVICE_Context; |
130 | 133 | ||
134 | |||
131 | /** | 135 | /** |
132 | * Run a service startup sequence within an existing | 136 | * Run a service startup sequence within an existing |
133 | * initialized system. | 137 | * initialized system. |
@@ -155,7 +159,7 @@ GNUNET_SERVICE_get_server (struct GNUNET_SERVICE_Context *ctx); | |||
155 | 159 | ||
156 | 160 | ||
157 | /** | 161 | /** |
158 | * Stop a service that was started with "GNUNET_SERVICE_start". | 162 | * Stop a service that was started with #GNUNET_SERVICE_start. |
159 | * | 163 | * |
160 | * @param sctx the service context returned from the start function | 164 | * @param sctx the service context returned from the start function |
161 | */ | 165 | */ |
@@ -170,6 +174,10 @@ GNUNET_SERVICE_stop (struct GNUNET_SERVICE_Context *sctx); | |||
170 | } | 174 | } |
171 | #endif | 175 | #endif |
172 | 176 | ||
177 | |||
178 | /** @} */ /* end of group service */ | ||
179 | |||
180 | |||
173 | /* ifndef GNUNET_SERVICE_LIB_H */ | 181 | /* ifndef GNUNET_SERVICE_LIB_H */ |
174 | #endif | 182 | #endif |
175 | /* end of gnunet_service_lib.h */ | 183 | /* end of gnunet_service_lib.h */ |