Add MEASUREMENTS response handler stub, add doc

Author: embediver

examples/spdm_requester.rs

@@ -493,6 +493,14 @@ fn full_flow(stream: TcpStream, config: &RequesterConfig) -> IoResult<()> {
         println!("GET_MEASUREMENTS: {:?}", &message_buffer.message_data());
     }
 
+    spdm_context
+        .requester_process_message(&mut message_buffer)
+        .unwrap();
+
+    if config.verbose {
+        println!("CHALLENGE_AUTH: {:x?}", &message_buffer.message_data());
+    }
+
     Ok(())
 }
 

src/commands/measurements/request.rs

@@ -11,6 +11,27 @@ use crate::{
     state::ConnectionState,
 };
 
+/// Generate a GET_MEASUREMENTS request
+///
+/// # Arguments
+/// * `ctx`: The SPDM context
+/// * `req_buf`: Buffer to write the request into
+/// * `raw_bitstream_requested`: Request a raw bit stream (if supported) (SPDM v1.2+)
+/// * `new_measurement_requested`: Request new measurement if the responder has pending updates to blocks (SPDM v1.3+)
+/// * `meas_op`: Measurement operation
+///     (0x00: query total number of available blocks, 0x01-0xFE: query block, 0xFF: query all blocks)
+/// * `slot_id`: Request a signed measurement if provided, signed with certificate slot identifier (0-7)
+/// * `context`: Append optional 8 byte context (SPDM v1.3+)
+///
+/// # Returns
+/// - () on success
+/// - [CommandError] on failure
+///
+/// # Connection State Requirements
+/// - Connection state must be >= AlgorithmsNegotiated
+///
+/// # Transcript
+/// - Appends request to the L1 transcript context
 pub fn generate_get_measurements<'a>(
     ctx: &mut SpdmContext<'a>,
     req_buf: &mut MessageBuf<'a>,
@@ -125,3 +146,12 @@ fn responder_supports_signed_measurements(ctx: &SpdmContext<'_>) -> bool {
         return false;
     }
 }
+
+/// Handle an incoming MEASUREMENTS response
+pub(crate) fn handle_measurements_response<'a>(
+    ctx: &mut SpdmContext<'a>,
+    resp_header: SpdmMsgHdr,
+    resp: &mut MessageBuf<'a>,
+) -> CommandResult<()> {
+    todo!()
+}

src/context.rs

@@ -8,6 +8,7 @@ use crate::commands::capabilities::handle_capabilities_response;
 use crate::commands::challenge::handle_challenge_auth_response;
 use crate::commands::digests::{handle_digests_response, handle_get_digests};
 use crate::commands::error_rsp::{encode_error_response, ErrorCode};
+use crate::commands::measurements::request::handle_measurements_response;
 use crate::commands::version::handle_version_response;
 use crate::commands::{
     algorithms, capabilities, certificate, challenge, chunk_get_rsp, measurements, version,
@@ -226,6 +227,7 @@ impl<'a> SpdmContext<'a> {
             ReqRespCode::ChallengeAuth => {
                 handle_challenge_auth_response(self, resp_msg_header, resp)?
             }
+            ReqRespCode::Measurements => handle_measurements_response(self, resp_msg_header, resp)?,
             _ => Err((false, CommandError::UnsupportedResponse))?,
         }