Branch data Line data Source code
1 : : /**
2 : : * Copyright Notice:
3 : : * Copyright 2021-2026 DMTF. All rights reserved.
4 : : * License: BSD 3-Clause License. For full text see link: https://github.com/DMTF/libspdm/blob/main/LICENSE.md
5 : : **/
6 : :
7 : : #include "internal/libspdm_requester_lib.h"
8 : : #include "internal/libspdm_secured_message_lib.h"
9 : :
10 : : #if (LIBSPDM_ENABLE_CAPABILITY_KEY_EX_CAP) || (LIBSPDM_ENABLE_CAPABILITY_PSK_CAP)
11 : :
12 : : #pragma pack(1)
13 : : typedef struct {
14 : : spdm_message_header_t header;
15 : : uint8_t dummy_data[sizeof(spdm_error_data_response_not_ready_t)];
16 : : } libspdm_end_session_response_mine_t;
17 : : #pragma pack()
18 : :
19 : : /**
20 : : * This function sends END_SESSION and receives END_SESSION_ACK for SPDM session end.
21 : : *
22 : : * @param spdm_context A pointer to the SPDM context.
23 : : * @param session_id session_id to the END_SESSION request.
24 : : * @param end_session_attributes end_session_attributes to the END_SESSION request.
25 : : **/
26 : 32 : static libspdm_return_t libspdm_try_send_receive_end_session(libspdm_context_t *spdm_context,
27 : : uint32_t session_id,
28 : : uint8_t end_session_attributes)
29 : : {
30 : : libspdm_return_t status;
31 : : spdm_end_session_request_t *spdm_request;
32 : : size_t spdm_request_size;
33 : : libspdm_end_session_response_mine_t *spdm_response;
34 : : size_t spdm_response_size;
35 : : libspdm_session_info_t *session_info;
36 : : libspdm_session_state_t session_state;
37 : : uint8_t *message;
38 : : size_t message_size;
39 : : size_t transport_header_size;
40 : :
41 [ - + ]: 32 : if (libspdm_get_connection_version(spdm_context) < SPDM_MESSAGE_VERSION_11) {
42 : 0 : return LIBSPDM_STATUS_UNSUPPORTED_CAP;
43 : : }
44 : :
45 [ + + ]: 32 : if (spdm_context->connection_info.connection_state <
46 : : LIBSPDM_CONNECTION_STATE_NEGOTIATED) {
47 : 1 : return LIBSPDM_STATUS_INVALID_STATE_LOCAL;
48 : : }
49 : 31 : session_info = libspdm_get_session_info_via_session_id(spdm_context, session_id);
50 [ - + ]: 31 : if (session_info == NULL) {
51 : 0 : LIBSPDM_ASSERT(false);
52 : 0 : return LIBSPDM_STATUS_INVALID_STATE_LOCAL;
53 : : }
54 : 31 : session_state = libspdm_secured_message_get_session_state(
55 : : session_info->secured_message_context);
56 [ - + ]: 31 : if (session_state != LIBSPDM_SESSION_STATE_ESTABLISHED) {
57 : 0 : return LIBSPDM_STATUS_INVALID_STATE_LOCAL;
58 : : }
59 : :
60 [ + - ]: 31 : if (!libspdm_is_capabilities_flag_supported(
61 : : spdm_context, true, 0,
62 : : SPDM_GET_CAPABILITIES_RESPONSE_FLAGS_CACHE_CAP)) {
63 : 31 : end_session_attributes = 0;
64 : : }
65 : :
66 : 31 : transport_header_size = spdm_context->local_context.capability.transport_header_size;
67 : 31 : status = libspdm_acquire_sender_buffer (spdm_context, &message_size, (void **)&message);
68 [ - + ]: 31 : if (LIBSPDM_STATUS_IS_ERROR(status)) {
69 : 0 : return status;
70 : : }
71 [ - + ]: 31 : LIBSPDM_ASSERT (message_size >= transport_header_size +
72 : : spdm_context->local_context.capability.transport_tail_size);
73 : 31 : spdm_request = (void *)(message + transport_header_size);
74 : 31 : spdm_request_size = message_size - transport_header_size -
75 : 31 : spdm_context->local_context.capability.transport_tail_size;
76 : :
77 [ - + ]: 31 : LIBSPDM_ASSERT (spdm_request_size >= sizeof(spdm_end_session_request_t));
78 : 31 : spdm_request->header.spdm_version = libspdm_get_connection_version (spdm_context);
79 : 31 : spdm_request->header.request_response_code = SPDM_END_SESSION;
80 : 31 : spdm_request->header.param1 = end_session_attributes;
81 : 31 : spdm_request->header.param2 = 0;
82 : :
83 : 31 : spdm_request_size = sizeof(spdm_end_session_request_t);
84 : 31 : status = libspdm_send_spdm_request(spdm_context, &session_id, spdm_request_size, spdm_request);
85 [ + + ]: 31 : if (LIBSPDM_STATUS_IS_ERROR(status)) {
86 : 1 : libspdm_release_sender_buffer (spdm_context);
87 : 1 : return status;
88 : : }
89 : :
90 : 30 : libspdm_reset_message_buffer_via_request_code(spdm_context, session_info, SPDM_END_SESSION);
91 : :
92 : 30 : libspdm_release_sender_buffer (spdm_context);
93 : 30 : spdm_request = (void *)spdm_context->last_spdm_request;
94 : :
95 : : /* receive */
96 : :
97 : 30 : status = libspdm_acquire_receiver_buffer (spdm_context, &message_size, (void **)&message);
98 [ - + ]: 30 : if (LIBSPDM_STATUS_IS_ERROR(status)) {
99 : 0 : return status;
100 : : }
101 [ - + ]: 30 : LIBSPDM_ASSERT (message_size >= transport_header_size);
102 : 30 : spdm_response = (void *)(message);
103 : 30 : spdm_response_size = message_size;
104 : :
105 : 30 : status = libspdm_receive_spdm_response(
106 : : spdm_context, &session_id, &spdm_response_size, (void **)&spdm_response);
107 [ - + ]: 30 : if (LIBSPDM_STATUS_IS_ERROR(status)) {
108 : 0 : goto receive_done;
109 : : }
110 [ - + ]: 30 : if (spdm_response_size < sizeof(spdm_message_header_t)) {
111 : 0 : status = LIBSPDM_STATUS_INVALID_MSG_SIZE;
112 : 0 : goto receive_done;
113 : : }
114 [ + + ]: 30 : if (spdm_response->header.request_response_code == SPDM_ERROR) {
115 : 25 : status = libspdm_handle_error_response_main(
116 : : spdm_context, &session_id, &spdm_response_size,
117 : : (void **)&spdm_response, SPDM_END_SESSION, SPDM_END_SESSION_ACK);
118 [ + + ]: 25 : if (LIBSPDM_STATUS_IS_ERROR(status)) {
119 : 24 : goto receive_done;
120 : : }
121 [ - + ]: 5 : } else if (spdm_response->header.request_response_code != SPDM_END_SESSION_ACK) {
122 : 0 : status = LIBSPDM_STATUS_INVALID_MSG_FIELD;
123 : 0 : goto receive_done;
124 : : }
125 [ - + ]: 6 : if (spdm_response->header.spdm_version != spdm_request->header.spdm_version) {
126 : 0 : status = LIBSPDM_STATUS_INVALID_MSG_FIELD;
127 : 0 : goto receive_done;
128 : : }
129 : : /* this message can only be in secured session
130 : : * thus don't need to consider transport layer padding, just check its exact size */
131 [ - + ]: 6 : if (spdm_response_size != sizeof(spdm_end_session_response_t)) {
132 : 0 : status = LIBSPDM_STATUS_INVALID_MSG_SIZE;
133 : 0 : goto receive_done;
134 : : }
135 : :
136 : 6 : session_info->end_session_attributes = end_session_attributes;
137 : :
138 : 6 : libspdm_secured_message_set_session_state(
139 : : session_info->secured_message_context,
140 : : LIBSPDM_SESSION_STATE_NOT_STARTED);
141 : 6 : libspdm_free_session_id(spdm_context, session_id);
142 : :
143 : 6 : status = LIBSPDM_STATUS_SUCCESS;
144 : :
145 : : /* -=[Log Message Phase]=- */
146 : : #if LIBSPDM_ENABLE_MSG_LOG
147 : 6 : libspdm_append_msg_log(spdm_context, spdm_response, spdm_response_size);
148 : : #endif /* LIBSPDM_ENABLE_MSG_LOG */
149 : :
150 : 30 : receive_done:
151 : 30 : libspdm_release_receiver_buffer (spdm_context);
152 : 30 : return status;
153 : : }
154 : :
155 : 31 : libspdm_return_t libspdm_send_receive_end_session(libspdm_context_t *spdm_context,
156 : : uint32_t session_id,
157 : : uint8_t end_session_attributes)
158 : : {
159 : : size_t retry;
160 : : uint64_t retry_delay_time;
161 : : libspdm_return_t status;
162 : :
163 : 31 : spdm_context->crypto_request = true;
164 : 31 : retry = spdm_context->retry_times;
165 : 31 : retry_delay_time = spdm_context->retry_delay_time;
166 : : do {
167 : 32 : status = libspdm_try_send_receive_end_session(
168 : : spdm_context, session_id, end_session_attributes);
169 [ + + ]: 32 : if (status != LIBSPDM_STATUS_BUSY_PEER) {
170 : 30 : return status;
171 : : }
172 : :
173 : 2 : libspdm_sleep(retry_delay_time);
174 [ + + ]: 2 : } while (retry-- != 0);
175 : :
176 : 1 : return status;
177 : : }
178 : :
179 : : #endif /* (LIBSPDM_ENABLE_CAPABILITY_KEY_EX_CAP) || (LIBSPDM_ENABLE_CAPABILITY_PSK_CAP) */
|