[age restriction] progress 4/n

- parser for age groups
- stringify age mask

1 files changed, 50 insertions, 13 deletions

diff --git a/src/include/taler_extensions.h b/src/include/taler_extensions.h
index 0ef69a78d..1ef97b2e9 100644
--- a/src/include/taler_extensions.h
+++ b/src/include/taler_extensions.h
@@ -1,18 +1,18 @@
 /*
-  This file is part of TALER
-  Copyright (C) 2014-2021 Taler Systems SA
+   This file is part of TALER
+   Copyright (C) 2014-2021 Taler Systems SA
 
-  TALER 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.
+   TALER 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.
 
-  TALER 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.
+   TALER 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.
 
-  You should have received a copy of the GNU General Public License along with
-  TALER; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
-*/
+   You should have received a copy of the GNU General Public License along with
+   TALER; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
+ */
 /**
  * @file include/taler_extensions.h
  * @brief Interface for extensions
@@ -21,14 +21,51 @@
 #ifndef TALER_EXTENSIONS_H
 #define TALER_EXTENSIONS_H
 
+#include <gnunet/gnunet_util_lib.h>
+
+
+#define TALER_EXTENSION_SECTION_PREFIX "exchange-extension-"
+
+enum TALER_EXTENSION_ReturnValue
+{
+  TALER_EXTENSION_OK = 0,
+  TALER_EXTENSION_ERROR_PARSING = 1,
+  TALER_EXTENSION_ERROR_INVALID = 2,
+  TALER_EXTENSION_ERROR_SYS = 3
+};
+
+
+/*
+ * TALER Age Restriction Extensions
+ */
+
+#define TALER_EXTENSION_SECTION_AGE_RESTRICTION TALER_EXTENSION_SECTION_PREFIX \
+  "agerestriction"
+
+/**
+ * The default age mask represents the age groups
+ * 0-7, 8-9, 10-11, 12-13, 14-15, 16-17, 18-20, 21-...
+ */
+#define TALER_EXTENSION_DEFAULT_AGE_MASK (1 | 1 << 8 | 1 << 10 | 1 << 12 | 1 << \
+                                          14 | 1 << 16 | 1 << 18 | 1 << 21)
+
+/**
+ * @param groups String representation of age groups, like: "8:10:12:14:16:18:21"
+ * @param[out] mask Mask representation for age restriction.
+ * @return Error, if age groups were invalid, OK otherwise.
+ */
+enum TALER_EXTENSION_ReturnValue
+TALER_parse_age_group_string (char *groups,
+                              struct TALER_AgeMask *mask);
+
 /**
  *
  * @param cfg
- * @param[out] mask for age restriction
+ * @param[out] mask for age restriction, will be set to 0 if age restriction is disabled.
  * @return Error if extension for age restriction was set but age groups were
  *         invalid, OK otherwise.
  */
-enum GNUNET_GenericReturnValue
+enum TALER_EXTENSION_ReturnValue
 TALER_get_age_mask (const struct GNUNET_CONFIGURATION_Handle *cfg,
                     struct TALER_AgeMask *mask);