noxtls-io 0.2.12

Internal implementation crate for noxtls: transport traits and blocking/async TLS record I/O adapters.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

// Copyright (c) 2019-2026, Argenox Technologies LLC
// All rights reserved.
//
// SPDX-License-Identifier: GPL-2.0-only OR LicenseRef-Argenox-Commercial-License
//
// This file is part of the NoxTLS Library.
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by the
// Free Software Foundation; version 2 of the License.
//
// Alternatively, this file may be used under the terms of a commercial
// license from Argenox Technologies LLC.
//
// See `noxtls/LICENSE` and `noxtls/LICENSE.md` in this repository for full details.
// CONTACT: info@argenox.com

//! Async helpers that combine [`super::stream_async::AsyncByteStream`] with TLS record deframing.

use crate::internal_alloc::Vec;
use crate::record::TlsRecordDeframer;

use super::stream_async::AsyncByteStream;
use super::TransportError;

/// Reads from `stream` until `deframer` yields one complete TLS record packet.
///
/// # Errors
///
/// Returns [`TransportError::UnexpectedEof`] when the stream closes before a full record arrives,
/// or transport errors from the underlying async read.
pub async fn noxtls_read_record_async<S: AsyncByteStream>(
    stream: &mut S,
    deframer: &mut TlsRecordDeframer,
) -> Result<Vec<u8>, TransportError> {
    loop {
        if let Some(packet) = deframer
            .pop_packet()
            .map_err(|_| TransportError::IoFailed("tls record deframer rejected length"))?
        {
            return Ok(packet);
        }
        let mut chunk = [0_u8; 4096];
        let n = stream.read_async(&mut chunk).await?;
        if n == 0 {
            return Err(TransportError::UnexpectedEof);
        }
        deframer.push(&chunk[..n]);
    }
}

/// Writes every byte in `data` through `stream` (symmetry with blocking `write_all`).
pub async fn noxtls_write_all_async<S: AsyncByteStream>(
    stream: &mut S,
    data: &[u8],
) -> Result<(), TransportError> {
    stream.write_all_async(data).await
}