]>
Commit | Line | Data |
---|---|---|
846e33c7 RS |
1 | /* |
2 | * Copyright 2015-2016 The OpenSSL Project Authors. All Rights Reserved. | |
8ba708e5 | 3 | * |
846e33c7 RS |
4 | * Licensed under the OpenSSL license (the "License"). You may not use |
5 | * this file except in compliance with the License. You can obtain a copy | |
6 | * in the file LICENSE in the source distribution or at | |
7 | * https://www.openssl.org/source/license.html | |
8ba708e5 MC |
8 | */ |
9 | ||
10 | /***************************************************************************** | |
11 | * * | |
8483a003 | 12 | * These enums should be considered PRIVATE to the state machine. No * |
8ba708e5 MC |
13 | * non-state machine code should need to use these * |
14 | * * | |
15 | *****************************************************************************/ | |
16 | /* | |
17 | * Valid return codes used for functions performing work prior to or after | |
18 | * sending or receiving a message | |
19 | */ | |
be3583fa | 20 | typedef enum { |
8ba708e5 MC |
21 | /* Something went wrong */ |
22 | WORK_ERROR, | |
23 | /* We're done working and there shouldn't be anything else to do after */ | |
24 | WORK_FINISHED_STOP, | |
25 | /* We're done working move onto the next thing */ | |
26 | WORK_FINISHED_CONTINUE, | |
27 | /* We're working on phase A */ | |
28 | WORK_MORE_A, | |
29 | /* We're working on phase B */ | |
30 | WORK_MORE_B | |
be3583fa | 31 | } WORK_STATE; |
8ba708e5 MC |
32 | |
33 | /* Write transition return codes */ | |
be3583fa | 34 | typedef enum { |
8ba708e5 MC |
35 | /* Something went wrong */ |
36 | WRITE_TRAN_ERROR, | |
37 | /* A transition was successfully completed and we should continue */ | |
38 | WRITE_TRAN_CONTINUE, | |
39 | /* There is no more write work to be done */ | |
40 | WRITE_TRAN_FINISHED | |
be3583fa | 41 | } WRITE_TRAN; |
8ba708e5 | 42 | |
8ba708e5 | 43 | /* Message flow states */ |
be3583fa | 44 | typedef enum { |
8ba708e5 MC |
45 | /* No handshake in progress */ |
46 | MSG_FLOW_UNINITED, | |
47 | /* A permanent error with this connection */ | |
48 | MSG_FLOW_ERROR, | |
8ba708e5 MC |
49 | /* We are reading messages */ |
50 | MSG_FLOW_READING, | |
51 | /* We are writing messages */ | |
52 | MSG_FLOW_WRITING, | |
53 | /* Handshake has finished */ | |
54 | MSG_FLOW_FINISHED | |
be3583fa | 55 | } MSG_FLOW_STATE; |
8ba708e5 MC |
56 | |
57 | /* Read states */ | |
be3583fa | 58 | typedef enum { |
8ba708e5 MC |
59 | READ_STATE_HEADER, |
60 | READ_STATE_BODY, | |
61 | READ_STATE_POST_PROCESS | |
be3583fa | 62 | } READ_STATE; |
8ba708e5 MC |
63 | |
64 | /* Write states */ | |
be3583fa | 65 | typedef enum { |
8ba708e5 MC |
66 | WRITE_STATE_TRANSITION, |
67 | WRITE_STATE_PRE_WORK, | |
68 | WRITE_STATE_SEND, | |
69 | WRITE_STATE_POST_WORK | |
be3583fa | 70 | } WRITE_STATE; |
8ba708e5 | 71 | |
8ba708e5 MC |
72 | /***************************************************************************** |
73 | * * | |
74 | * This structure should be considered "opaque" to anything outside of the * | |
75 | * state machine. No non-state machine code should be accessing the members * | |
76 | * of this structure. * | |
77 | * * | |
78 | *****************************************************************************/ | |
79 | ||
d6f1a6e9 | 80 | struct ossl_statem_st { |
be3583fa MC |
81 | MSG_FLOW_STATE state; |
82 | WRITE_STATE write_state; | |
83 | WORK_STATE write_state_work; | |
84 | READ_STATE read_state; | |
85 | WORK_STATE read_state_work; | |
35bf6e05 | 86 | OSSL_HANDSHAKE_STATE hand_state; |
0386aad1 MC |
87 | /* The handshake state requested by an API call (e.g. HelloRequest) */ |
88 | OSSL_HANDSHAKE_STATE request_state; | |
8ba708e5 MC |
89 | int in_init; |
90 | int read_state_first_init; | |
024f543c MC |
91 | /* true when we are actually in SSL_accept() or SSL_connect() */ |
92 | int in_handshake; | |
c7f47786 MC |
93 | /* |
94 | * True when are processing a "real" handshake that needs cleaning up (not | |
95 | * just a HelloRequest or similar). | |
96 | */ | |
97 | int cleanuphand; | |
a71a4966 MC |
98 | /* Should we skip the CertificateVerify message? */ |
99 | unsigned int no_cert_verify; | |
8ba708e5 MC |
100 | int use_timer; |
101 | #ifndef OPENSSL_NO_SCTP | |
102 | int in_sctp_read_sock; | |
103 | #endif | |
104 | }; | |
d6f1a6e9 | 105 | typedef struct ossl_statem_st OSSL_STATEM; |
8ba708e5 | 106 | |
8ba708e5 MC |
107 | /***************************************************************************** |
108 | * * | |
109 | * The following macros/functions represent the libssl internal API to the * | |
110 | * state machine. Any libssl code may call these functions/macros * | |
111 | * * | |
112 | *****************************************************************************/ | |
113 | ||
fe3a3291 MC |
114 | __owur int ossl_statem_accept(SSL *s); |
115 | __owur int ossl_statem_connect(SSL *s); | |
116 | void ossl_statem_clear(SSL *s); | |
117 | void ossl_statem_set_renegotiate(SSL *s); | |
118 | void ossl_statem_set_error(SSL *s); | |
119 | int ossl_statem_in_error(const SSL *s); | |
120 | void ossl_statem_set_in_init(SSL *s, int init); | |
024f543c MC |
121 | int ossl_statem_get_in_handshake(SSL *s); |
122 | void ossl_statem_set_in_handshake(SSL *s, int inhand); | |
31fd10e6 | 123 | void ossl_statem_set_hello_verify_done(SSL *s); |
fe3a3291 | 124 | __owur int ossl_statem_app_data_allowed(SSL *s); |
8ba708e5 | 125 | #ifndef OPENSSL_NO_SCTP |
fe3a3291 MC |
126 | void ossl_statem_set_sctp_read_sock(SSL *s, int read_sock); |
127 | __owur int ossl_statem_in_sctp_read_sock(SSL *s); | |
8ba708e5 | 128 | #endif |