gnunet-service-messenger_member_session.h

Go to the documentation of this file.

/*
   This file is part of GNUnet.
   Copyright (C) 2021--2024 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_MESSENGER_MEMBER_SESSION_H
#define GNUNET_SERVICE_MESSENGER_MEMBER_SESSION_H
 
#include "gnunet_util_lib.h"
#include "gnunet_time_lib.h"
 
#include "gnunet-service-messenger_list_messages.h"
#include "gnunet-service-messenger_member.h"
 
#include "messenger_api_contact.h"
 
struct GNUNET_MESSENGER_MemberSession
{
  struct GNUNET_MESSENGER_Member *member;
 
  struct GNUNET_CRYPTO_PublicKey public_key;
  struct GNUNET_HashCode context;
 
  struct GNUNET_MESSENGER_Contact *contact;
 
  struct GNUNET_CONTAINER_MultiHashMap *history;
  struct GNUNET_MESSENGER_ListMessages messages;
 
  struct GNUNET_MESSENGER_MemberSession *prev;
  struct GNUNET_MESSENGER_MemberSession *next;
 
  struct GNUNET_TIME_Absolute start;
 
  enum GNUNET_GenericReturnValue closed;
  enum GNUNET_GenericReturnValue completed;
};
 
struct GNUNET_MESSENGER_MemberSession*
create_member_session (struct GNUNET_MESSENGER_Member *member,
                       const struct GNUNET_CRYPTO_PublicKey *pubkey);
 
struct GNUNET_MESSENGER_MemberSession*
switch_member_session (struct GNUNET_MESSENGER_MemberSession *session,
                       const struct GNUNET_MESSENGER_Message *message,
                       const struct GNUNET_HashCode *hash);
 
void
destroy_member_session (struct GNUNET_MESSENGER_MemberSession *session);
 
enum GNUNET_GenericReturnValue
reset_member_session (struct GNUNET_MESSENGER_MemberSession *session,
                      const struct GNUNET_HashCode *hash);
 
void
close_member_session (struct GNUNET_MESSENGER_MemberSession *session);
 
enum GNUNET_GenericReturnValue
is_member_session_closed (const struct GNUNET_MESSENGER_MemberSession *session);
 
enum GNUNET_GenericReturnValue
is_member_session_completed (const struct
                             GNUNET_MESSENGER_MemberSession *session);
 
struct GNUNET_TIME_Absolute
get_member_session_start (const struct GNUNET_MESSENGER_MemberSession *session);
 
const struct GNUNET_HashCode*
get_member_session_key (const struct GNUNET_MESSENGER_MemberSession *session);
 
const struct GNUNET_ShortHashCode*
get_member_session_id (const struct GNUNET_MESSENGER_MemberSession *session);
 
const struct GNUNET_CRYPTO_PublicKey*
get_member_session_public_key (const struct
                               GNUNET_MESSENGER_MemberSession *session);
 
const struct GNUNET_HashCode*
get_member_session_context (const struct
                            GNUNET_MESSENGER_MemberSession *session);
 
struct GNUNET_MESSENGER_Contact*
get_member_session_contact (struct GNUNET_MESSENGER_MemberSession *session);
 
enum GNUNET_GenericReturnValue
verify_member_session_as_sender (const struct
                                 GNUNET_MESSENGER_MemberSession *session,
                                 const struct GNUNET_MESSENGER_Message *message,
                                 const struct GNUNET_HashCode *hash);
 
enum GNUNET_GenericReturnValue
check_member_session_history (const struct
                              GNUNET_MESSENGER_MemberSession *session,
                              const struct GNUNET_HashCode *hash,
                              enum GNUNET_GenericReturnValue ownership);
 
void
update_member_session_history (struct GNUNET_MESSENGER_MemberSession *session,
                               const struct GNUNET_MESSENGER_Message *message,
                               const struct GNUNET_HashCode *hash);
 
void
clear_member_session_history (struct GNUNET_MESSENGER_MemberSession *session,
                              const struct GNUNET_HashCode *hash);
 
void
load_member_session (struct GNUNET_MESSENGER_Member *member,
                     const char *directory);
 
void
load_member_session_next (struct GNUNET_MESSENGER_MemberSession *session,
                          const char *directory);
 
void
save_member_session (struct GNUNET_MESSENGER_MemberSession *session,
                     const char *directory);
 
#endif //GNUNET_SERVICE_MESSENGER_MEMBER_SESSION_H