Repository: nushell/nushell
File: crates/nu-command/src/network/port.rs (Rust)

Code before:
use nu_engine::command_prelude::*;
use nu_protocol::shell_error::io::IoError;

use std::net::{Ipv4Addr, SocketAddr, SocketAddrV4, TcpListener};

#[derive(Clone)]
pub struct Port;

impl Command for Port {
    fn name(&self) -> &str {
        "port"
    }

    fn signature(&self) -> Signature {
        Signature::build("port")
            .input_output_types(vec![(Type::Nothing, Type::Int)])
            .optional(
                "start",
                SyntaxShape::Int,
                "The start port to scan (inclusive).",
            )
            .optional("end", SyntaxShape::Int, "The end port to scan (inclusive).")
            .category(Category::Network)
    }

    fn description(&self) -> &str {
        "Get a free port from system."
    }

    fn search_terms(&self) -> Vec<&str> {
        vec!["network", "http"]
    }

    fn run(
        &self,
        engine_state: &EngineState,
        stack: &mut Stack,
        call: &Call,
        _input: PipelineData,
    ) -> Result<PipelineData, ShellError> {
        get_free_port(engine_state, stack, call)
    }

    fn examples(&self) -> Vec<Example> {
        vec![
            Example {
                description: "get a free port between 3121 and 4000",
                example: "port 3121 4000",
                result: Some(Value::test_int(3121)),
            },
            Example {
                description: "get a free port from system",
                example: "port",
                result: None,
            },
        ]
    }
}

fn get_free_port(
    engine_state: &EngineState,
    stack: &mut Stack,
    call: &Call,
) -> Result<PipelineData, ShellError> {
    let from_io_error = IoError::factory(call.head, None);

    let start_port: Option<Spanned<usize>> = call.opt(engine_state, stack, 0)?;
    let end_port: Option<Spanned<usize>> = call.opt(engine_state, stack, 1)?;

    let listener = if start_port.is_none() && end_port.is_none() {
        // get free port from system.
        TcpListener::bind("127.0.0.1:0").map_err(&from_io_error)?
    } else {
        let (start_port, start_span) = match start_port {
            Some(p) => (p.item, Some(p.span)),
            None => (1024, None),
        };

        let start_port = match u16::try_from(start_port) {
            Ok(p) => p,
            Err(e) => {
                return Err(ShellError::CantConvert {
                    to_type: "u16".into(),
                    from_type: "usize".into(),
                    span: start_span.unwrap_or(call.head),
                    help: Some(format!("{e} (min: {}, max: {})", u16::MIN, u16::MAX)),
                });
            }
        };

        let (end_port, end_span) = match end_port {
            Some(p) => (p.item, Some(p.span)),
            None => (65535, None),
        };

        let end_port = match u16::try_from(end_port) {
            Ok(p) => p,
            Err(e) => {
                return Err(ShellError::CantConvert {
                    to_type: "u16".into(),
                    from_type: "usize".into(),
                    span: end_span.unwrap_or(call.head),
                    help: Some(format!("{e} (min: {}, max: {})", u16::MIN, u16::MAX)),
                });
            }
        };

        let range_span = match (start_span, end_span) {
            (Some(start), Some(end)) => Span::new(start.start, end.end),
            (Some(start), None) => start,
            (None, Some(end)) => end,
            (None, None) => call.head,
        };

        // check input range valid.
        if start_port > end_port {
            return Err(ShellError::InvalidRange {
                left_flank: start_port.to_string(),
                right_flank: end_port.to_string(),
                span: range_span,
            });
        }

        'search: {
            let mut last_err = None;
            for port in start_port..=end_port {
                let addr = SocketAddr::V4(SocketAddrV4::new(Ipv4Addr::LOCALHOST, port));
                match TcpListener::bind(addr) {
                    Ok(listener) => break 'search Ok(listener),
                    Err(err) => last_err = Some(err),
                }
            }

            Err(IoError::new_with_additional_context(
                last_err.expect("range not empty, validated before"),
                range_span,
                None,
                "Every port has been tried, but no valid one was found",
            ))
        }?
    };

    let free_port = listener.local_addr().map_err(&from_io_error)?.port();
    Ok(Value::int(free_port as i64, call.head).into_pipeline_data())
}


Review comment (bug):
My lawyer-y reading of https://learn.microsoft.com/en-us/windows/win32/api/iphlpapi/nf-iphlpapi-gettcptable2 is that it only guarantees that it will return the `ERROR_INSUFFICIENT_BUFFER` on passing of a NULL pointer to `(p)TcpTable`.

Code after:
            ERROR_INSUFFICIENT_BUFFER, ERROR_INVALID_PARAMETER, ERROR_NOT_SUPPORTED, NO_ERROR,
            WIN32_ERROR,
        },
        NetworkManagement::IpHelper::{GetTcpTable2, MIB_TCPROW2, MIB_TCPTABLE2},
        Networking::WinSock::ntohs,
    };

    #[repr(C)]
    struct TcpTable {
        pub num_entries: u32,
        pub table: [MIB_TCPROW2],
    }

    const _: () = assert!(align_of::<MIB_TCPTABLE2>() == 4);

    impl TcpTable {
        fn new() -> Result<Box<Self>, WIN32_ERROR> {
            let mut size = 0;
            let size_pointer: *mut u32 = &mut size;

            // SAFETY:
            // - Passing a null table pointer queries the required size (documented behavior).
            // - `size_pointer` is a valid, non-null out pointer.
            // - We expect `ERROR_INSUFFICIENT_BUFFER` so that `size` is written.
            let ret_code = unsafe { GetTcpTable2(None, size_pointer, false) };
            assert_eq!(WIN32_ERROR(ret_code), ERROR_INSUFFICIENT_BUFFER);

            // SAFETY:
            // - Alignment is 4: non-zero and a power of two.
            // - `size` comes from the API and is expected to be reasonable for allocation.
            let layout = unsafe {
                Layout::from_size_align_unchecked(size as usize, align_of::<MIB_TCPTABLE2>())
            };

            // IMPORTANT: This allocation must be freed or transferred to ownership before leaving this scope.
            // SAFETY: `layout` has non-zero size (at least 4 for one u32).
            let ptr = unsafe { alloc(layout) as *mut MIB_TCPTABLE2 };
            assert!(!ptr.is_null());

            // SAFETY:
            // - `ptr` is non-null, properly aligned, and points to `size` bytes.
            // - `size_pointer` still points to `size` from the first call.
            let ret_code = unsafe { GetTcpTable2(Some(ptr), size_pointer, false) };
            let ret_code = WIN32_ERROR(ret_code);
            if ret_code != NO_ERROR {
                // SAFETY:
                // - `ptr` was allocated with `alloc(layout)` in this function.
                // - Using the same `layout` to deallocate is correct.
                unsafe { dealloc(ptr as *mut u8, layout) };
                return Err(ret_code);
            }