gnunet-service-cadet_connection.h

Go to the documentation of this file.

/*
     This file is part of GNUnet.
     Copyright (C) 2001-2017 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_SERVICE_CADET_CONNECTION_H
#define GNUNET_SERVICE_CADET_CONNECTION_H
 
#include "gnunet_util_lib.h"
#include "gnunet-service-cadet.h"
#include "gnunet-service-cadet_peer.h"
#include "cadet_protocol.h"
 
 
typedef void
(*GCC_ReadyCallback)(void *cls,
                     int is_ready);
 
 
void
GCC_destroy_without_core (struct CadetConnection *cc);
 
 
void
GCC_destroy_without_tunnel (struct CadetConnection *cc);
 
 
struct CadetConnection *
GCC_lookup (const struct GNUNET_CADET_ConnectionTunnelIdentifier *cid);
 
 
struct CadetConnection *
GCC_create (struct CadetPeer *destination,
            struct CadetPeerPath *path,
            unsigned int off,
            struct CadetTConnection *ct,
            GCC_ReadyCallback ready_cb,
            void *ready_cb_cls);
 
 
struct CadetConnection *
GCC_create_inbound (struct CadetPeer *destination,
                    struct CadetPeerPath *path,
                    struct CadetTConnection *ct,
                    const struct GNUNET_CADET_ConnectionTunnelIdentifier *cid,
                    GCC_ReadyCallback ready_cb,
                    void *ready_cb_cls);
 
 
void
GCC_transmit (struct CadetConnection *cc,
              struct GNUNET_MQ_Envelope *env);
 
 
void
GCC_handle_connection_create_ack (struct CadetConnection *cc);
 
 
void
GCC_handle_duplicate_create (struct CadetConnection *cc);
 
 
void
GCC_handle_kx (struct CadetConnection *cc,
               const struct GNUNET_CADET_TunnelKeyExchangeMessage *msg);
 
 
void
GCC_handle_kx_auth (struct CadetConnection *cc,
                    const struct
                    GNUNET_CADET_TunnelKeyExchangeAuthMessage *msg);
 
struct CadetConnectionCreatePS
{
 
  struct GNUNET_CRYPTO_EccSignaturePurpose purpose;
 
  struct GNUNET_TIME_AbsoluteNBO monotonic_time;
 
};
 
struct CadetConnectionMetrics
{
  struct GNUNET_TIME_Relative aged_latency;
 
  struct GNUNET_TIME_Absolute age;
 
  struct GNUNET_TIME_Absolute last_use;
 
  unsigned long long num_acked_transmissions;
 
  unsigned long long num_successes;
};
 
 
const struct CadetConnectionMetrics *
GCC_get_metrics (struct CadetConnection *cc);
 
 
void
GCC_handle_encrypted (struct CadetConnection *cc,
                      const struct GNUNET_CADET_TunnelEncryptedMessage *msg);
 
 
void
GCC_ack_expected (const struct GNUNET_CADET_ConnectionTunnelIdentifier *cid);
 
 
void
GCC_ack_observed (const struct GNUNET_CADET_ConnectionTunnelIdentifier *cid);
 
 
void
GCC_latency_observed (const struct GNUNET_CADET_ConnectionTunnelIdentifier *cti,
                      struct GNUNET_TIME_Relative latency);
 
 
struct CadetTConnection *
GCC_get_ct (struct CadetConnection *cc);
 
 
struct CadetPeerPath *
GCC_get_path (struct CadetConnection *cc,
              unsigned int *off);
 
 
const struct GNUNET_CADET_ConnectionTunnelIdentifier *
GCC_get_id (struct CadetConnection *cc);
 
 
const char *
GCC_2s (const struct CadetConnection *cc);
 
 
void
GCC_debug (struct CadetConnection *cc,
           enum GNUNET_ErrorType level);
 
 
#endif