Frequently Asked Questions

use ironrdp::connector::{self, Credentials};
use ironrdp_blocking::Framed;
use std::net::TcpStream;

// Create configuration
let config = connector::Config {
    credentials: Credentials::UsernamePassword {
        username: "user".to_string(),
        password: "pass".to_string(),
    },
    desktop_size: connector::DesktopSize {
        width: 1280,
        height: 1024,
    },
    // ... other fields
};

// Connect
let stream = TcpStream::connect("10.0.0.100:3389")?;
let mut framed = Framed::new(stream);
let mut connector = connector::ClientConnector::new(config, client_addr);

let should_upgrade = ironrdp_blocking::connect_begin(&mut framed, &mut connector)?;
// ... TLS upgrade and finalization

use ironrdp_svc::{SvcProcessor, SvcMessage};

struct MyChannel;

impl SvcProcessor for MyChannel {
    fn channel_name(&self) -> ChannelName {
        ChannelName::from_static(b"mychan\0\0")
    }

    fn process(&mut self, payload: &[u8]) -> PduResult<Vec<SvcMessage>> {
        // Process incoming data
        Ok(vec![])
    }
}

use ironrdp_dvc::{DvcProcessor, DvcMessage};

struct MyDynamicChannel;

impl DvcProcessor for MyDynamicChannel {
    fn channel_name(&self) -> &str {
        "MyDynamicChannel"
    }

    fn process(&mut self, channel_id: u32, payload: &[u8]) -> PduResult<Vec<DvcMessage>> {
        // Process incoming data
        Ok(vec![])
    }
}

# Show all IronRDP logs at info level
IRONRDP_LOG=info cargo run

# Debug level for specific module
IRONRDP_LOG=ironrdp_connector=debug cargo run

# Trace level for everything
IRONRDP_LOG=trace cargo run

# Multiple modules with different levels
IRONRDP_LOG="ironrdp_pdu=debug,ironrdp_session=trace" cargo run

use tracing::info;

info!(%server_addr, "Connected to server");

use ironrdp_tokio::TokioFramed;
use tokio::net::TcpStream;

// Async connection
let stream = TcpStream::connect("10.0.0.100:3389").await?;
let mut framed = TokioFramed::new(stream);

// Use async versions of connect functions
let should_upgrade = ironrdp_async::connect_begin(&mut framed, &mut connector).await?;

IRONRDP_LOG=ironrdp_cliprdr=debug cargo run

Set-ItemProperty -Path 'HKLM:\Software\Policies\Microsoft\Windows NT\Terminal Services' `
  -Name 'ColorDepth' -Type DWORD -Value 5

Set-ItemProperty -Path 'HKLM:\Software\Policies\Microsoft\Windows NT\Terminal Services' `
  -Name 'fEnableVirtualizedGraphics' -Type DWORD -Value 1

# Run all tests
cargo xtask check tests -v

# Run tests for specific crate
cargo test -p ironrdp-pdu

# Run specific test
cargo test -p ironrdp-pdu test_name

# Run with logging
IRONRDP_LOG=debug cargo test -p ironrdp-connector

# Run full CI suite locally
cargo xtask ci -v

#![no_main]

use libfuzzer_sys::fuzz_target;
use ironrdp_pdu::MyPdu;
use ironrdp_core::{Decode, ReadCursor};

fuzz_target!(|data: &[u8]| {
    let mut cursor = ReadCursor::new(data);
    let _ = MyPdu::decode(&mut cursor);
});

[[bin]]
name = "my_pdu"
path = "fuzz_targets/my_pdu.rs"
test = false
doc = false

cargo xtask fuzz run my_pdu

cargo xtask bootstrap -v