gnunet_core_underlay.h

Go to the documentation of this file.

/*
     This file is part of GNUnet.
     Copyright (C) 2009-2023 GNUnet e.V.
 
     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
     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 <http://www.gnu.org/licenses/>.
 
     SPDX-License-Identifier: AGPL3.0-or-later
 */
#ifndef GNUNET_CORE_UNDERLAY_SERVICE_H
#define GNUNET_CORE_UNDERLAY_SERVICE_H
 
#ifdef __cplusplus
extern "C" {
#if 0 /* keep Emacsens' auto-indent happy */
}
#endif
#endif
 
 
#include "gnunet_util_lib.h"
#include "gnunet_transport_communication_service.h"
 
#define GNUNET_CORE_UNDERLAY_VERSION 0x00000000
 
 
struct GNUNET_CORE_UNDERLAY_Handle;
 
 
typedef void *(*GNUNET_CORE_UNDERLAY_NotifyConnect) (
  void *cls,
  uint32_t num_addresses;
  const char *addresses[static num_addresses],
  struct GNUNET_MQ_Handle *mq);
 
 
typedef void (*GNUNET_CORE_UNDERLAY_NotifyDisconnect) (
  void *cls,
  void *handler_cls);
 
 
typedef void (*GNUNET_CORE_UNDERLAY_NotifyAddressChange) (
  void *cls,
  struct GNUNET_HashCode network_location_hash,
  struct uint64_t network_generation_id);
 
 
struct GNUNET_CORE_UNDERLAY_Handle *
GNUNET_CORE_UNDERLAY_connect (const struct GNUNET_CONFIGURATION_Handle *cfg,
                              const struct GNUNET_MQ_MessageHandler *handlers,
                              void *cls,
                              GNUNET_CORE_UNDERLAY_NotifyConnect nc,
                              GNUNET_CORE_UNDERLAY_NotifyDisconnect nd,
                              GNUNET_CORE_UNDERLAY_NotifyAddressChange na);
 
 
void
GNUNET_CORE_UNDERLAY_disconnect (struct GNUNET_CORE_UNDERLAY_Handle *handle);
 
 
void
GNUNET_CORE_UNDERLAY_receive_continue (struct GNUNET_CORE_UNDERLAY_Handle *ch,
                                       struct GNUNET_MQ_Handle *mq);
 
 
void
GNUNET_CORE_UNDERLAY_connect_to_peer (struct GNUNET_CORE_UNDERLAY_Handle *ch,
                                      const char *peer_address
                                      enum GNUNET_MQ_PriorityPreferences pp,
                                      struct GNUNET_BANDWIDTH_Value32NBO bw);
 
 
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif
 
/* ifndef GNUNET_CORE_UNDERLAY_SERVICE_H */
#endif
 
 
 
/* end of gnunet_core_underlay_service.h */