src/gns/gnunet-service-gns.h

   1 /*
   2      This file is part of GNUnet.
   3      Copyright (C) 2018 GNUnet e.V.
   4
   5      GNUnet is free software: you can redistribute it and/or modify it
   6      under the terms of the GNU Affero General Public License as published
   7      by the Free Software Foundation, either version 3 of the License,
   8      or (at your option) any later version.
   9
  10      GNUnet is distributed in the hope that it will be useful, but
  11      WITHOUT ANY WARRANTY; without even the implied warranty of
  12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13      Affero General Public License for more details.
  14
  15      You should have received a copy of the GNU Affero General Public License
  16      along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17
  18      SPDX-License-Identifier: AGPL3.0-or-later
  19 */
  20 /**
  21  * @file gns/gnunet-service-gns.h
  22  * @brief GNU Name System (main service)
  23  * @author Martin Schanzenbach
  24  * @author Christian Grothoff
  25  */
  26 #ifndef GNUNET_SERVICE_GNS_H
  27 #define GNUNET_SERVICE_GNS_H
  28
  29
  30 /**
  31  * Find GNS zone belonging to TLD @a tld.
  32  *
  33  * @param tld_str top-level domain to look up
  34  * @param[out] pkey public key to set
  35  * @return #GNUNET_YES if @a tld was found #GNUNET_NO if not
  36  */
  37 int
  38 GNS_find_tld (const char *tld_str,
  39               struct GNUNET_CRYPTO_EcdsaPublicKey *pkey);
  40
  41
  42 /**
  43  * Obtain the TLD of the given @a name.
  44  *
  45  * @param name a name
  46  * @return the part of @a name after the last ".",
  47  *         or @a name if @a name does not contain a "."
  48  */
  49 const char *
  50 GNS_get_tld (const char *name);
  51
  52
  53 #endif