OpenVPN
session_id.h
Go to the documentation of this file.
1 /*
2  * OpenVPN -- An application to securely tunnel IP networks
3  * over a single UDP port, with support for SSL/TLS-based
4  * session authentication and key exchange,
5  * packet encryption, packet authentication, and
6  * packet compression.
7  *
8  * Copyright (C) 2002-2017 OpenVPN Technologies, Inc. <sales@openvpn.net>
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License version 2
12  * as published by the Free Software Foundation.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License along
20  * with this program; if not, write to the Free Software Foundation, Inc.,
21  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
22  */
23 
24 /*
25  * Each session is identified by a random 8-byte session identifier.
26  *
27  * For efficiency, the session id is only transmitted over the control
28  * channel (which only sees traffic occasionally when keys are being
29  * negotiated).
30  */
31 
32 #ifdef ENABLE_CRYPTO
33 
34 #ifndef SESSION_ID_H
35 #define SESSION_ID_H
36 
37 #include "basic.h"
38 #include "buffer.h"
39 
40 struct session_id
41 {
42  uint8_t id[8];
43 };
44 
45 extern const struct session_id x_session_id_zero;
46 
47 #define SID_SIZE (sizeof(x_session_id_zero.id))
48 
49 static inline bool
50 session_id_equal(const struct session_id *sid1,
51  const struct session_id *sid2)
52 {
53  return !memcmp(sid1->id, sid2->id, SID_SIZE);
54 }
55 
56 static inline bool
57 session_id_defined(const struct session_id *sid1)
58 {
59  return memcmp(sid1->id, &x_session_id_zero.id, SID_SIZE) != 0;
60 }
61 
62 static inline bool
63 session_id_read(struct session_id *sid, struct buffer *buf)
64 {
65  return buf_read(buf, sid->id, SID_SIZE);
66 }
67 
68 static inline bool
69 session_id_write_prepend(const struct session_id *sid, struct buffer *buf)
70 {
71  return buf_write_prepend(buf, sid->id, SID_SIZE);
72 }
73 
74 static inline bool
75 session_id_write(const struct session_id *sid, struct buffer *buf)
76 {
77  return buf_write(buf, sid->id, SID_SIZE);
78 }
79 
80 void session_id_random(struct session_id *sid);
81 
82 const char *session_id_print(const struct session_id *sid, struct gc_arena *gc);
83 
84 #endif /* SESSION_ID_H */
85 #endif /* ENABLE_CRYPTO */
static bool session_id_equal(const struct session_id *sid1, const struct session_id *sid2)
Definition: session_id.h:50
static bool session_id_write(const struct session_id *sid, struct buffer *buf)
Definition: session_id.h:75
#define SID_SIZE
Definition: session_id.h:47
static bool buf_read(struct buffer *src, void *dest, int size)
Definition: buffer.h:774
static bool buf_write(struct buffer *dest, const void *src, int size)
Definition: buffer.h:663
uint8_t id[8]
Definition: session_id.h:42
void session_id_random(struct session_id *sid)
Definition: session_id.c:53
const char * session_id_print(const struct session_id *sid, struct gc_arena *gc)
Definition: session_id.c:59
static bool session_id_defined(const struct session_id *sid1)
Definition: session_id.h:57
static bool session_id_read(struct session_id *sid, struct buffer *buf)
Definition: session_id.h:63
const struct session_id x_session_id_zero
Definition: session_id.c:50
unsigned __int8 uint8_t
Definition: config-msvc.h:123
Wrapper structure for dynamically allocated memory.
Definition: buffer.h:60
static bool buf_write_prepend(struct buffer *dest, const void *src, int size)
Definition: buffer.h:675
Garbage collection arena used to keep track of dynamically allocated memory.
Definition: buffer.h:116
static bool session_id_write_prepend(const struct session_id *sid, struct buffer *buf)
Definition: session_id.h:69