gnunet_transport_service.h

Go to the documentation of this file.

/*
     This file is part of GNUnet.
     Copyright (C) 2009-2016 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_TRANSPORT_SERVICE_H
#define GNUNET_TRANSPORT_SERVICE_H
 
#ifdef __cplusplus
extern "C" {
#if 0 /* keep Emacsens' auto-indent happy */
}
#endif
#endif
 
 
#include "gnunet_util_lib.h"
#include "gnunet_ats_service.h"
 
#define GNUNET_TRANSPORT_VERSION 0x00000003
 
 
/* *************************** HELLO *************************** */
 
struct GNUNET_TRANSPORT_OfferHelloHandle;
 
 
struct GNUNET_TRANSPORT_OfferHelloHandle *
GNUNET_TRANSPORT_offer_hello (const struct GNUNET_CONFIGURATION_Handle *cfg,
                              const struct GNUNET_MessageHeader *hello,
                              GNUNET_SCHEDULER_TaskCallback cont,
                              void *cont_cls);
 
 
void
GNUNET_TRANSPORT_offer_hello_cancel (
  struct GNUNET_TRANSPORT_OfferHelloHandle *ohh);
 
 
/* *********************** Address to String ******************* */
 
struct GNUNET_TRANSPORT_AddressToStringContext;
 
 
typedef void
(*GNUNET_TRANSPORT_AddressToStringCallback) (void *cls,
                                             const char *address,
                                             int res);
 
 
struct GNUNET_TRANSPORT_AddressToStringContext *
GNUNET_TRANSPORT_address_to_string (
  const struct GNUNET_CONFIGURATION_Handle *cfg,
  const struct GNUNET_HELLO_Address *address,
  int numeric,
  struct GNUNET_TIME_Relative timeout,
  GNUNET_TRANSPORT_AddressToStringCallback aluc,
  void *aluc_cls);
 
 
void
GNUNET_TRANSPORT_address_to_string_cancel (
  struct GNUNET_TRANSPORT_AddressToStringContext *alc);
 
 
/* *********************** Monitoring ************************** */
 
 
enum GNUNET_TRANSPORT_PeerState
{
  GNUNET_TRANSPORT_PS_NOT_CONNECTED = 0,
 
  GNUNET_TRANSPORT_PS_INIT_ATS,
 
  GNUNET_TRANSPORT_PS_SYN_SENT,
 
  GNUNET_TRANSPORT_PS_SYN_RECV_ATS,
 
  GNUNET_TRANSPORT_PS_SYN_RECV_ACK,
 
  GNUNET_TRANSPORT_PS_CONNECTED,
 
  GNUNET_TRANSPORT_PS_RECONNECT_ATS,
 
  GNUNET_TRANSPORT_PS_RECONNECT_SENT,
 
  GNUNET_TRANSPORT_PS_SWITCH_SYN_SENT,
 
  GNUNET_TRANSPORT_PS_DISCONNECT,
 
  GNUNET_TRANSPORT_PS_DISCONNECT_FINISHED
};
 
 
const char *
GNUNET_TRANSPORT_ps2s (enum GNUNET_TRANSPORT_PeerState state);
 
 
int
GNUNET_TRANSPORT_is_connected (enum GNUNET_TRANSPORT_PeerState state);
 
 
struct GNUNET_TRANSPORT_PeerMonitoringContext;
 
 
typedef void
(*GNUNET_TRANSPORT_PeerIterateCallback) (
  void *cls,
  const struct GNUNET_PeerIdentity *peer,
  const struct GNUNET_HELLO_Address *address,
  enum GNUNET_TRANSPORT_PeerState state,
  struct GNUNET_TIME_Absolute state_timeout);
 
 
struct GNUNET_TRANSPORT_PeerMonitoringContext *
GNUNET_TRANSPORT_monitor_peers (
  const struct GNUNET_CONFIGURATION_Handle *cfg,
  const struct GNUNET_PeerIdentity *peer,
  int one_shot,
  GNUNET_TRANSPORT_PeerIterateCallback peer_callback,
  void *peer_callback_cls);
 
 
void
GNUNET_TRANSPORT_monitor_peers_cancel (
  struct GNUNET_TRANSPORT_PeerMonitoringContext *pic);
 
 
/* *********************** Blacklisting ************************ */
 
struct GNUNET_TRANSPORT_Blacklist;
 
 
typedef int
(*GNUNET_TRANSPORT_BlacklistCallback) (
  void *cls,
  const struct GNUNET_PeerIdentity *pid);
 
 
struct GNUNET_TRANSPORT_Blacklist *
GNUNET_TRANSPORT_blacklist (const struct GNUNET_CONFIGURATION_Handle *cfg,
                            GNUNET_TRANSPORT_BlacklistCallback cb,
                            void *cb_cls);
 
 
void
GNUNET_TRANSPORT_blacklist_cancel (struct GNUNET_TRANSPORT_Blacklist *br);
 
 
struct GNUNET_TRANSPORT_PluginMonitor;
 
struct GNUNET_TRANSPORT_PluginSession;
 
 
enum GNUNET_TRANSPORT_SessionState
{
  GNUNET_TRANSPORT_SS_INIT,
 
  GNUNET_TRANSPORT_SS_HANDSHAKE,
 
  GNUNET_TRANSPORT_SS_UP,
 
  GNUNET_TRANSPORT_SS_UPDATE,
 
  GNUNET_TRANSPORT_SS_DONE
};
 
 
struct GNUNET_TRANSPORT_SessionInfo
{
  enum GNUNET_TRANSPORT_SessionState state;
 
  int is_inbound;
 
  uint32_t num_msg_pending;
 
  uint32_t num_bytes_pending;
 
  struct GNUNET_TIME_Absolute receive_delay;
 
  struct GNUNET_TIME_Absolute session_timeout;
 
  const struct GNUNET_HELLO_Address *address;
};
 
 
typedef void
(*GNUNET_TRANSPORT_SessionMonitorCallback) (
  void *cls,
  struct GNUNET_TRANSPORT_PluginSession *session,
  void **session_ctx,
  const struct GNUNET_TRANSPORT_SessionInfo *info);
 
 
struct GNUNET_TRANSPORT_PluginMonitor *
GNUNET_TRANSPORT_monitor_plugins (const struct GNUNET_CONFIGURATION_Handle *cfg,
                                  GNUNET_TRANSPORT_SessionMonitorCallback cb,
                                  void *cb_cls);
 
 
void
GNUNET_TRANSPORT_monitor_plugins_cancel (
  struct GNUNET_TRANSPORT_PluginMonitor *pm);
 
 
struct GNUNET_TRANSPORT_CoreHandle;
 
 
typedef void *
(*GNUNET_TRANSPORT_NotifyConnect) (
  void *cls,
  const struct GNUNET_PeerIdentity *peer,
  struct GNUNET_MQ_Handle *mq);
 
 
typedef void
(*GNUNET_TRANSPORT_NotifyDisconnect) (
  void *cls,
  const struct GNUNET_PeerIdentity *peer,
  void *handler_cls);
 
 
typedef void
(*GNUNET_TRANSPORT_NotifyExcessBandwidth) (
  void *cls,
  const struct GNUNET_PeerIdentity *neighbour,
  void *handlers_cls);
 
 
struct GNUNET_TRANSPORT_CoreHandle *
GNUNET_TRANSPORT_core_connect (const struct GNUNET_CONFIGURATION_Handle *cfg,
                               const struct GNUNET_PeerIdentity *self,
                               const struct GNUNET_MQ_MessageHandler *handlers,
                               void *cls,
                               GNUNET_TRANSPORT_NotifyConnect nc,
                               GNUNET_TRANSPORT_NotifyDisconnect nd,
                               GNUNET_TRANSPORT_NotifyExcessBandwidth neb);
 
 
void
GNUNET_TRANSPORT_core_disconnect (struct GNUNET_TRANSPORT_CoreHandle *handle);
 
 
struct GNUNET_MQ_Handle *
GNUNET_TRANSPORT_core_get_mq (struct GNUNET_TRANSPORT_CoreHandle *handle,
                              const struct GNUNET_PeerIdentity *peer);
 
 
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif
 
/* ifndef GNUNET_TRANSPORT_SERVICE_H */
#endif
 /* end of group */
 /* end of group addition */
 
/* end of gnunet_transport_service.h */