socket2 0.6.5: socket2

# This file is automatically @generated by Cargo.
# It is not intended for manual editing.
version = 4

[[package]]
name = "libc"
version = "0.2.189"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"

[[package]]
name = "sample-socket2"
version = "1.0.0"
dependencies = [
 "socket2",
]

[[package]]
name = "socket2"
version = "0.6.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c3d1e2c7f27f8d4cb10542a02c49005dbd6e93095799d6f3be745fae9f8fedd4"
dependencies = [
 "libc",
 "windows-sys",
]

[[package]]
name = "windows-link"
version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"

[[package]]
name = "windows-sys"
version = "0.61.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
dependencies = [
 "windows-link",
]

[package]
name = "sample-socket2"
version = "1.0.0"
edition = "2021"
publish = false

[dependencies]
socket2 = "=0.6.5"

[[bin]]
name = "contract"
path = "test/contract.rs"

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify socket2 in pkg:cargo/socket2@0.6.5
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/socket2@0.6.5
Demonstrate these symbols/APIs:
  - socket2

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:8f38b9baff60d1ceccf1a5af3a8b0b8556a8df51adcd994a6ae13b079fbd8fef","contract":["Socket::new creates IPv4 and IPv6 stream and datagram sockets with specified protocols","Socket binds to local IPv4 loopback address and retrieves bound local_addr via SockAddr","Socket configures standard socket options including nonblocking, reuse_address, tcp_nodelay, and ttl_v4","Socket configures and reads back read and write timeouts with Duration","Socket converts to standard TcpListener and UdpSocket and supports SockRef borrowing"],"goal":"verify socket2 in pkg:cargo/socket2@0.6.5","kind":"HOW","packages":["pkg:cargo/socket2@0.6.5"],"schemaVersion":1,"symbols":["socket2"]},"contractCommand":["cargo","run","--offline"],"environment":{"arch":"x64","distro":"alpine","ecosystem":"cargo","libc":"musl","os":"linux","packageManager":"cargo","schemaVersion":1},"license":"MIT-0","packages":["pkg:cargo/socket2@0.6.5"],"schemaVersion":1,"subject":"pkg:cargo/socket2@0.6.5","symbols":["socket2"],"verifierAdapter":"cargo@1"}

{
  "schemaVersion": 1,
  "goal": "verify socket2 in pkg:cargo/socket2@0.6.5",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/socket2@0.6.5"
  ],
  "symbols": [
    "socket2"
  ]
}

//! Clean-room verification sample for socket2.

pub use socket2::*;

use socket2::{Domain, Protocol, SockAddr, SockRef, Socket, Type};
use std::net::{Ipv4Addr, SocketAddr, SocketAddrV4, TcpListener, UdpSocket};
use std::time::Duration;

fn main() {
    // 1. Socket::new creates IPv4 and IPv6 stream and datagram sockets with specified protocols
    let tcp_v4 = Socket::new(Domain::IPV4, Type::STREAM, Some(Protocol::TCP))
        .expect("create IPv4 TCP socket");
    let udp_v4 = Socket::new(Domain::IPV4, Type::DGRAM, Some(Protocol::UDP))
        .expect("create IPv4 UDP socket");
    let tcp_v6 = Socket::new(Domain::IPV6, Type::STREAM, Some(Protocol::TCP))
        .expect("create IPv6 TCP socket");
    assert_eq!(
        Domain::for_address(SocketAddr::V4(SocketAddrV4::new(Ipv4Addr::LOCALHOST, 80))),
        Domain::IPV4
    );
    drop(tcp_v4);
    drop(udp_v4);
    drop(tcp_v6);

    // 2. Socket binds to local IPv4 loopback address and retrieves bound local_addr via SockAddr
    let socket = Socket::new(Domain::IPV4, Type::STREAM, Some(Protocol::TCP))
        .expect("create stream socket");
    let bind_addr: SocketAddr = "127.0.0.1:0".parse().unwrap();
    let sock_addr = SockAddr::from(bind_addr);
    socket.bind(&sock_addr).expect("bind socket");
    let bound_addr = socket.local_addr().expect("get local_addr");
    let bound_socket_addr = bound_addr.as_socket_ipv4().expect("as_socket_ipv4");
    assert_eq!(bound_socket_addr.ip(), &Ipv4Addr::LOCALHOST);
    assert!(bound_socket_addr.port() > 0);

    // 3. Socket configures standard socket options including nonblocking, reuse_address, tcp_nodelay, and ttl_v4
    socket.set_reuse_address(true).expect("set_reuse_address");
    socket.set_nonblocking(true).expect("set_nonblocking");
    socket.set_tcp_nodelay(true).expect("set_tcp_nodelay");
    assert_eq!(socket.tcp_nodelay().expect("get tcp_nodelay"), true);
    socket.set_ttl_v4(64).expect("set_ttl_v4");
    assert_eq!(socket.ttl_v4().expect("get ttl_v4"), 64);

    // 4. Socket configures and reads back read and write timeouts with Duration
    let timeout = Some(Duration::from_secs(5));
    socket.set_read_timeout(timeout).expect("set_read_timeout");
    assert_eq!(socket.read_timeout().expect("get read_timeout"), timeout);
    socket.set_write_timeout(timeout).expect("set_write_timeout");
    assert_eq!(socket.write_timeout().expect("get write_timeout"), timeout);

    // 5. Socket converts to standard TcpListener and UdpSocket and supports SockRef borrowing
    socket.listen(128).expect("listen on socket");
    let std_listener: TcpListener = socket.into();
    let sock_ref = SockRef::from(&std_listener);
    assert_eq!(sock_ref.tcp_nodelay().expect("sock_ref tcp_nodelay"), true);

    let udp_sock = Socket::new(Domain::IPV4, Type::DGRAM, Some(Protocol::UDP))
        .expect("create udp socket");
    let any_udp_addr: SocketAddr = "127.0.0.1:0".parse().unwrap();
    udp_sock.set_ttl_v4(32).expect("set udp ttl_v4");
    udp_sock.bind(&any_udp_addr.into()).expect("bind udp socket");
    let std_udp: UdpSocket = udp_sock.into();
    let udp_ref = SockRef::from(&std_udp);
    assert_eq!(udp_ref.ttl_v4().expect("udp_ref ttl_v4"), 32);

    println!("All socket2 contract assertions passed successfully.");
}