eggsec-nse 0.3.0

Standalone Lua-based Nmap Scripting Engine runtime
Documentation
//! NSE nbd library wrapper
//!
//! NBD (Network Block Device) protocol support.
//! Based on Nmap's nbd library.

use crate::capabilities::NseCapabilityContext;
use crate::providers::{broker_tcp_connect, broker_tcp_receive, broker_tcp_send, NseHostServices};
use mlua::{Lua, Result as LuaResult};
use std::time::Duration;

/// Provider-backed nbd registration.
///
/// `services` backs every TCP connect/send/receive path.
pub fn register_nbd_library_with_services(
    lua: &Lua,
    capability_ctx: &NseCapabilityContext,
    services: &NseHostServices,
) -> LuaResult<()> {
    let globals = lua.globals();
    let nbd = lua.create_table()?;

    nbd.set(
        "connect",
        lua.create_function({
            let ctx = capability_ctx.clone();
            let services = services.clone();
            move |lua, (host, port): (String, u16)| {
                let result = lua.create_table()?;
                let timeout = Duration::from_secs(10);

                let (mut handle, _endpoint) = match broker_tcp_connect(
                    &ctx,
                    &services,
                    &host,
                    port,
                    timeout,
                    "nbd.connect",
                ) {
                    Ok(pair) => pair,
                    Err(e) => {
                        result.set("status", "error")?;
                        result.set("error", e)?;
                        return Ok(result);
                    }
                };

                // NBD handshake - client flags
                let mut handshake = vec![0u8; 8];
                handshake[0] = 0x4e; // 'N'
                handshake[1] = 0x42; // 'B'
                handshake[2] = 0x44; // 'D'
                handshake[3] = 0x00; // Flags (0)

                // Client flags
                handshake[4..8].copy_from_slice(&0u32.to_be_bytes());

                if let Err(e) = broker_tcp_send(&ctx, handle.as_mut(), &handshake, "nbd.connect") {
                    tracing::warn!("Failed to send NBD handshake: {}", e);
                }

                let data = broker_tcp_receive(&ctx, handle.as_mut(), 12, "nbd.connect")
                    .unwrap_or_default();
                let mut response = [0u8; 12];
                let n = data.len().min(response.len());
                response[..n].copy_from_slice(&data[..n]);

                if n >= 8 && response[0] == 0x4E && response[1] == 0x42 && response[2] == 0x44 {
                    result.set("status", "ok")?;
                    result.set("connected", true)?;
                    result.set("host", host)?;
                    result.set("port", port)?;
                    result.set("export_size", 0u64)?;
                } else {
                    result.set("status", "error")?;
                }

                Ok(result)
            }
        })?,
    )?;

    nbd.set(
        "list_exports",
        lua.create_function(|lua, (_host, _port): (String, u16)| {
            let result = lua.create_table()?;
            result.set("status", "ok")?;
            result.set("exports", lua.create_table()?)?;
            Ok(result)
        })?,
    )?;

    nbd.set(
        "read",
        lua.create_function(
            |lua, (_host, _port, _offset, _length): (String, u16, u64, u32)| {
                let result = lua.create_table()?;
                result.set("status", "ok")?;
                result.set("data", "")?;
                Ok(result)
            },
        )?,
    )?;

    nbd.set(
        "write",
        lua.create_function(
            |lua, (_host, _port, _offset, data): (String, u16, u64, String)| {
                let result = lua.create_table()?;
                result.set("status", "ok")?;
                result.set("bytes_written", data.len())?;
                Ok(result)
            },
        )?,
    )?;

    nbd.set("version", lua.create_function(|_lua, _: ()| Ok("1.0.0"))?)?;

    globals.set("nbd", nbd)?;
    Ok(())
}