X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=src%2Finclude%2Fgnunet_statistics_service.h;h=94fa49358a44cc62ae6cd2ce95c691d2a0a07e01;hb=0d4f151374efb1972361c40b6624bf4fd0e3fcaa;hp=51dc503e7a08848048433b733989537447843a4f;hpb=c2d9d1e64c9801122caaa6b429fc67706db5c9d7;p=oweals%2Fgnunet.git diff --git a/src/include/gnunet_statistics_service.h b/src/include/gnunet_statistics_service.h index 51dc503e7..94fa49358 100644 --- a/src/include/gnunet_statistics_service.h +++ b/src/include/gnunet_statistics_service.h @@ -1,30 +1,38 @@ /* This file is part of GNUnet - Copyright (C) 2009-2013 Christian Grothoff (and other contributing authors) + Copyright (C) 2009-2013, 2016 GNUnet e.V. - GNUnet is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published - by the Free Software Foundation; either version 3, or (at your - option) any later version. + GNUnet is free software: you can redistribute it and/or modify it + under the terms of the GNU Affero General Public License as published + by the Free Software Foundation, either version 3 of the License, + or (at your option) any later version. GNUnet is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. + Affero General Public License for more details. + + You should have received a copy of the GNU Affero General Public License + along with this program. If not, see . - You should have received a copy of the GNU General Public License - along with GNUnet; see the file COPYING. If not, write to the - Free Software Foundation, Inc., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA. + SPDX-License-Identifier: AGPL3.0-or-later */ /** - * @file include/gnunet_statistics_service.h - * @brief API to create, modify and access statistics about - * the operation of GNUnet; all statistical values - * must be of type `unsigned long long`. * @author Christian Grothoff - * @defgroup statistics track statistics or provide access to statistics + * + * @file + * API to create, modify and access statistics. + * + * @defgroup statistics Statistics service + * Track statistics or provide access to statistics. + * + * Create, modify and access statistics about the operation of GNUnet. + * + * All statistical values must be of type `unsigned long long`. + * + * @see [Documentation](https://gnunet.org/gnunet-statistics-subsystem) + * * @{ */ @@ -130,14 +138,15 @@ GNUNET_STATISTICS_watch_cancel (struct GNUNET_STATISTICS_Handle *handle, /** - * Continuation called by #GNUNET_STATISTICS_get functions. + * Continuation called by #GNUNET_STATISTICS_get() functions. * * @param cls closure * @param success #GNUNET_OK if statistics were * successfully obtained, #GNUNET_SYSERR if not. */ -typedef void (*GNUNET_STATISTICS_Callback) (void *cls, - int success); +typedef void +(*GNUNET_STATISTICS_Callback) (void *cls, + int success); /** @@ -152,8 +161,6 @@ struct GNUNET_STATISTICS_GetHandle; * @param handle identification of the statistics service * @param subsystem limit to the specified subsystem, NULL for all subsystems * @param name name of the statistic value, NULL for all values - * @param timeout after how long should we give up (and call - * notify with buf NULL and size 0)? * @param cont continuation to call when done (can be NULL) * This callback CANNOT destroy the statistics handle in the same call. * @param proc function to call on each value @@ -164,9 +171,9 @@ struct GNUNET_STATISTICS_GetHandle * GNUNET_STATISTICS_get (struct GNUNET_STATISTICS_Handle *handle, const char *subsystem, const char *name, - struct GNUNET_TIME_Relative timeout, GNUNET_STATISTICS_Callback cont, - GNUNET_STATISTICS_Iterator proc, void *cls); + GNUNET_STATISTICS_Iterator proc, + void *cls); /**