tds-protocol

Part of the rust-mssql-driver project.

Pure Rust implementation of the MS-TDS (Tabular Data Stream) protocol used by Microsoft SQL Server.

Overview

This crate provides low-level, no_std-compatible protocol primitives for TDS versions 7.4 through 8.0. It is intentionally IO-agnostic and contains no networking or async runtime code.

Features

• no_std compatible - Works in embedded environments with alloc
• Zero unsafe code - Memory-safe by construction
• Protocol complete - Supports TDS 7.4, 7.4.1, and 8.0
• Well-tested - Fuzz-tested packet parsing

Usage

This crate is primarily used internally by mssql-client. Direct usage is for advanced scenarios:

use tds_protocol::{PacketHeader, PacketType, PacketStatus, PreLogin};

// Create a packet header
let header = PacketHeader::new(
    PacketType::PreLogin,
    PacketStatus::END_OF_MESSAGE,
    100,
);

// Encode to bytes
let bytes = header.encode_to_bytes();

// Create PreLogin message
let prelogin = PreLogin::new()
    .with_encryption(EncryptionLevel::Required);
let encoded = prelogin.encode();

Modules

Feature Flags

Protocol References

• MS-TDS Protocol Specification
• TDS 8.0 Specification

License

MIT OR Apache-2.0