GNUnet  0.11.x
messenger_api_message.h
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet.
3  Copyright (C) 2020--2021 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  */
26 #ifndef GNUNET_MESSENGER_API_MESSAGE_H
27 #define GNUNET_MESSENGER_API_MESSAGE_H
28 
29 #include "platform.h"
30 #include "gnunet_crypto_lib.h"
32 #include "gnunet_mq_lib.h"
33 #include "gnunet_signatures.h"
34 
36 
37 #include "messenger_api_ego.h"
38 
39 #define GNUNET_MESSENGER_MAX_MESSAGE_SIZE (GNUNET_MAX_MESSAGE_SIZE - GNUNET_MIN_MESSAGE_SIZE)
40 
41 #define GNUNET_MESSENGER_PADDING_MIN (sizeof(uint16_t) + sizeof(char))
42 #define GNUNET_MESSENGER_PADDING_LEVEL0 (512)
43 #define GNUNET_MESSENGER_PADDING_LEVEL1 (4096)
44 #define GNUNET_MESSENGER_PADDING_LEVEL2 (32768)
45 
54 
62 copy_message (const struct GNUNET_MESSENGER_Message *message);
63 
69 void
71 
78 int
80 
87 uint16_t
89 
97 uint16_t
98 get_message_size (const struct GNUNET_MESSENGER_Message *message,
99  int include_signature);
100 
109 void
110 encode_message (const struct GNUNET_MESSENGER_Message *message, uint16_t length, char *buffer,
111  int include_signature);
112 
127 int
128 decode_message (struct GNUNET_MESSENGER_Message *message, uint16_t length, const char *buffer,
129  int include_signature, uint16_t *padding);
130 
140 void
141 hash_message (const struct GNUNET_MESSENGER_Message *message, uint16_t length, const char *buffer,
142  struct GNUNET_HashCode *hash);
143 
154 void
155 sign_message (struct GNUNET_MESSENGER_Message *message, uint16_t length, char *buffer,
156  const struct GNUNET_HashCode *hash, const struct GNUNET_MESSENGER_Ego *ego);
157 
168 int
169 verify_message (const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash,
170  const struct GNUNET_IDENTITY_PublicKey *key);
171 
181 int
183 
193 int
195 
196 #define GNUNET_MESSENGER_PACK_MODE_ENVELOPE 0x1
197 #define GNUNET_MESSENGER_PACK_MODE_UNKNOWN 0x0
198 
211 struct GNUNET_MQ_Envelope*
212 pack_message (struct GNUNET_MESSENGER_Message *message, struct GNUNET_HashCode *hash,
213  const struct GNUNET_MESSENGER_Ego *ego, int mode);
214 
222 int
223 filter_message_sending (const struct GNUNET_MESSENGER_Message *message);
224 
225 #endif //GNUNET_MESSENGER_API_MESSAGE_H
uint16_t get_message_kind_size(enum GNUNET_MESSENGER_MessageKind kind)
Returns the minimal size in bytes to encode a message of a specific kind.
struct GNUNET_MESSENGER_Message * copy_message(const struct GNUNET_MESSENGER_Message *message)
Creates and allocates a copy of a given message.
void hash_message(const struct GNUNET_MESSENGER_Message *message, uint16_t length, const char *buffer, struct GNUNET_HashCode *hash)
Calculates a hash of a given buffer with a length in bytes from a message.
int encrypt_message(struct GNUNET_MESSENGER_Message *message, const struct GNUNET_IDENTITY_PublicKey *key)
Encrypts a message using a given public key and replaces its body and kind with the now private encry...
A private key for an identity as per LSD0001.
static enum @8 mode
Should we do a PUT (mode = 0) or GET (mode = 1);.
int verify_message(const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash, const struct GNUNET_IDENTITY_PublicKey *key)
Verifies the signature of a given message and its hash with a specific public key.
cryptographic primitives for GNUnet
int decode_message(struct GNUNET_MESSENGER_Message *message, uint16_t length, const char *buffer, int include_signature, uint16_t *padding)
Decodes a message from a given buffer of a maximal length in bytes.
void destroy_message(struct GNUNET_MESSENGER_Message *message)
Destroys a message and frees its memory fully.
int decrypt_message(struct GNUNET_MESSENGER_Message *message, const struct GNUNET_IDENTITY_PrivateKey *key)
Decrypts a private message using a given private key and replaces its body and kind with the inner en...
A 512-bit hashcode.
GNUnet MESSENGER service.
struct GNUNET_HashCode key
The key used in the DHT.
void sign_message(struct GNUNET_MESSENGER_Message *message, uint16_t length, char *buffer, const struct GNUNET_HashCode *hash, const struct GNUNET_MESSENGER_Ego *ego)
Signs the hash of a message with a given ego and writes the signature into the buffer as well...
An identity key as per LSD0001.
uint16_t get_message_size(const struct GNUNET_MESSENGER_Message *message, int include_signature)
Returns the exact size in bytes to encode a given message.
void encode_message(const struct GNUNET_MESSENGER_Message *message, uint16_t length, char *buffer, int include_signature)
Encodes a given message into a buffer of a maximal length in bytes.
GNUNET_MESSENGER_MessageKind
Enum for the different supported kinds of messages.
int filter_message_sending(const struct GNUNET_MESSENGER_Message *message)
Returns if a specific kind of message should be sent by a client.
struct GNUNET_MESSENGER_Message * create_message(enum GNUNET_MESSENGER_MessageKind kind)
Creates and allocates a new message with a specific kind.
int is_message_session_bound(const struct GNUNET_MESSENGER_Message *message)
Returns if the message should be bound to a member session.
struct GNUNET_MQ_Envelope * pack_message(struct GNUNET_MESSENGER_Message *message, struct GNUNET_HashCode *hash, const struct GNUNET_MESSENGER_Ego *ego, int mode)
Encodes the message to pack it into a newly allocated envelope if mode is equal to GNUNET_MESSENGER_P...