use std::fmt;
use crate::profile::NseExecutionProfileKind;
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum NseAutomatedLibraryEligibility {
Pure,
ProviderBacked,
ManualOnlyDirectIo,
ManualOnlyAdvisory,
}
impl fmt::Display for NseAutomatedLibraryEligibility {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
match self {
Self::Pure => write!(f, "Pure"),
Self::ProviderBacked => write!(f, "ProviderBacked"),
Self::ManualOnlyDirectIo => write!(f, "ManualOnlyDirectIo"),
Self::ManualOnlyAdvisory => write!(f, "ManualOnlyAdvisory"),
}
}
}
#[derive(Debug, Clone)]
pub struct LibraryEffectEntry {
pub name: &'static str,
pub source_module: &'static str,
pub register_fn: &'static str,
pub eligibility: NseAutomatedLibraryEligibility,
pub rationale: &'static str,
}
pub static LIBRARY_EFFECT_MANIFEST: &[LibraryEffectEntry] = &[
LibraryEffectEntry {
name: "afp",
source_module: "libraries/afp",
register_fn: "register_afp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "ajp",
source_module: "libraries/ajp",
register_fn: "register_ajp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "amqp",
source_module: "libraries/amqp",
register_fn: "register_amqp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "anyconnect",
source_module: "libraries/anyconnect",
register_fn: "register_anyconnect_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "asn1",
source_module: "libraries/asn1",
register_fn: "register_asn1_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure ASN.1 BER encode/decode; no I/O.",
},
LibraryEffectEntry {
name: "base32",
source_module: "libraries/base32",
register_fn: "register_base32_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure encode/decode; no host side effects.",
},
LibraryEffectEntry {
name: "base64",
source_module: "libraries/base64",
register_fn: "register_base64_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure encode/decode; no host side effects.",
},
LibraryEffectEntry {
name: "bin",
source_module: "libraries/bin",
register_fn: "register_bin_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure pack/unpack; no host side effects.",
},
LibraryEffectEntry {
name: "bit",
source_module: "libraries/bit",
register_fn: "register_bit_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure bitwise ops; no host side effects.",
},
LibraryEffectEntry {
name: "bitcoin",
source_module: "libraries/bitcoin",
register_fn: "register_bitcoin_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "bits",
source_module: "libraries/bits",
register_fn: "register_bits_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure bit-stream utilities; no host side effects.",
},
LibraryEffectEntry {
name: "bittorrent",
source_module: "libraries/bittorrent",
register_fn: "register_bittorrent_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "bjnp",
source_module: "libraries/bjnp",
register_fn: "register_bjnp_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Unconnected/broadcast UDP send/recv; not brokered (M005E ungated).",
},
LibraryEffectEntry {
name: "brute",
source_module: "libraries/brute",
register_fn: "register_brute_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: TCP login helpers use BrokeredTcpStream; HTTP-auth probes use broker_http_request; no direct socket effect remains.",
},
LibraryEffectEntry {
name: "cassandra",
source_module: "libraries/cassandra",
register_fn: "register_cassandra_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "citrixxml",
source_module: "libraries/citrixxml",
register_fn: "register_citrixxml_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "coap",
source_module: "libraries/coap",
register_fn: "register_coap_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct UDP/TCP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "comm",
source_module: "libraries/comm",
register_fn: "register_comm_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "All TCP/TLS go through broker_tcp_connect + maybe_denied_response.",
},
LibraryEffectEntry {
name: "creds",
source_module: "libraries/creds",
register_fn: "register_creds_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "In-memory credential store; no FS/network access.",
},
LibraryEffectEntry {
name: "cvs",
source_module: "libraries/cvs",
register_fn: "register_cvs_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "datafiles",
source_module: "libraries/datafiles",
register_fn: "register_datafiles_library",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Filesystem reads via nse_fs_read_to_string; capability-gated.",
},
LibraryEffectEntry {
name: "datetime",
source_module: "libraries/datetime",
register_fn: "register_datetime_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Clock routed through broker_unix_timestamp (provider-backed).",
},
LibraryEffectEntry {
name: "dhcp",
source_module: "libraries/dhcp",
register_fn: "register_dhcp_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyAdvisory,
rationale: "Capability ctx present; UDP send/recv paths bypass provider injection (M005E advisory).",
},
LibraryEffectEntry {
name: "dhcp6",
source_module: "libraries/dhcp6",
register_fn: "register_dhcp6_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyAdvisory,
rationale: "Capability ctx present; UDP send/recv paths bypass provider injection (M005E advisory).",
},
LibraryEffectEntry {
name: "dicom",
source_module: "libraries/dicom",
register_fn: "register_dicom_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "dns",
source_module: "libraries/dns",
register_fn: "register_dns_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "DNS broker + provider authority; resolve-select-connect identity preserved.",
},
LibraryEffectEntry {
name: "dnssd",
source_module: "libraries/dnssd",
register_fn: "register_dnssd_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct UDP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "drda",
source_module: "libraries/drda",
register_fn: "register_drda_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "eap",
source_module: "libraries/eap",
register_fn: "register_eap_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct UDP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "eigrp",
source_module: "libraries/eigrp",
register_fn: "register_eigrp_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Raw packet send/receive; no provider contract (M005E ungated).",
},
LibraryEffectEntry {
name: "finger",
source_module: "libraries/finger",
register_fn: "register_finger_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct TCP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "formulas",
source_module: "libraries/formulas",
register_fn: "register_formulas_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure numeric helpers; no host side effects.",
},
LibraryEffectEntry {
name: "ftp",
source_module: "libraries/ftp",
register_fn: "register_ftp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: all blocking-TCP core sites use BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "geoip",
source_module: "libraries/geoip",
register_fn: "register_geoip_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure lookup helpers; no I/O.",
},
LibraryEffectEntry {
name: "giop",
source_module: "libraries/giop",
register_fn: "register_giop_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Stub-only registration; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "gps",
source_module: "libraries/gps",
register_fn: "register_gps_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct UDP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "http",
source_module: "libraries/http",
register_fn: "register_http_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "All HTTP ops gated via check_network_tcp / maybe_denied_response; broker_http_request authority-bound path required.",
},
LibraryEffectEntry {
name: "http2",
source_module: "libraries/http2",
register_fn: "register_http2_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Reuses the http broker + provider.",
},
LibraryEffectEntry {
name: "httppipeline",
source_module: "libraries/httppipeline",
register_fn: "register_httppipeline_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Pipeline brokered HTTP via broker_http_request.",
},
LibraryEffectEntry {
name: "httpspider",
source_module: "libraries/httpspider",
register_fn: "register_httpspider_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Specialized native-HTTP-based crawler; not brokered (M005E specialized HTTP client).",
},
LibraryEffectEntry {
name: "iax2",
source_module: "libraries/iax2",
register_fn: "register_iax2_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct UDP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "idna",
source_module: "libraries/idna",
register_fn: "register_idna_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure IDNA encoding.",
},
LibraryEffectEntry {
name: "iec61850mms",
source_module: "libraries/iec61850mms",
register_fn: "register_iec61850mms_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "ike",
source_module: "libraries/ike",
register_fn: "register_ike_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct UDP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "imap",
source_module: "libraries/imap",
register_fn: "register_imap_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "informix",
source_module: "libraries/informix",
register_fn: "register_informix_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "io",
source_module: "libraries/io",
register_fn: "register_io_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "FS/process brokers; capability-gated.",
},
LibraryEffectEntry {
name: "ipmi",
source_module: "libraries/ipmi",
register_fn: "register_ipmi_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct UDP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "ipops",
source_module: "libraries/ipops",
register_fn: "register_ipops_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure IP/CIDR parsing; no host side effects.",
},
LibraryEffectEntry {
name: "ipp",
source_module: "libraries/ipp",
register_fn: "register_ipp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "irc",
source_module: "libraries/irc",
register_fn: "register_irc_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "iscsi",
source_module: "libraries/iscsi",
register_fn: "register_iscsi_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "isns",
source_module: "libraries/isns",
register_fn: "register_isns_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "jdwp",
source_module: "libraries/jdwp",
register_fn: "register_jdwp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "json",
source_module: "libraries/json",
register_fn: "register_json_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure JSON encode/decode.",
},
LibraryEffectEntry {
name: "kafka",
source_module: "libraries/kafka",
register_fn: "register_kafka_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct TCP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "knx",
source_module: "libraries/knx",
register_fn: "register_knx_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct UDP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "ldap",
source_module: "libraries/ldap",
register_fn: "register_ldap_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "lfs",
source_module: "libraries/lfs",
register_fn: "register_lfs_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "LuaFileSystem via filesystem broker; sandboxed.",
},
LibraryEffectEntry {
name: "libssh2",
source_module: "libraries/libssh2",
register_fn: "register_libssh2_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyAdvisory,
rationale: "Capability ctx accepted; native handle handoff to libssh2 remains manual (M005E advisory).",
},
LibraryEffectEntry {
name: "libssh2_utility",
source_module: "libraries/libssh2_utility",
register_fn: "register_libssh2_utility_library_with_services",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure utility helpers over libssh2 (no direct I/O).",
},
LibraryEffectEntry {
name: "listop",
source_module: "libraries/listop",
register_fn: "register_listop_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure list operations.",
},
LibraryEffectEntry {
name: "lpeg",
source_module: "libraries/lpeg",
register_fn: "register_lpeg_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure parsing expression grammar.",
},
LibraryEffectEntry {
name: "lpeg_utility",
source_module: "libraries/lpeg_utility",
register_fn: "register_lpeg_utility_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure LPeg helpers.",
},
LibraryEffectEntry {
name: "ls",
source_module: "libraries/ls",
register_fn: "register_ls_library",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Filesystem reads via provider; capability-gated.",
},
LibraryEffectEntry {
name: "match_lib",
source_module: "libraries/match_lib",
register_fn: "register_match_lib_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure match helpers (not registered as global in current set; defensive).",
},
LibraryEffectEntry {
name: "matchs",
source_module: "libraries/matchs",
register_fn: "register_matchs_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure structured match helpers.",
},
LibraryEffectEntry {
name: "membase",
source_module: "libraries/membase",
register_fn: "register_membase_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "memcached",
source_module: "libraries/memcached",
register_fn: "register_memcached_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "mobileme",
source_module: "libraries/mobileme",
register_fn: "register_mobileme_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Specialized HTTP client; uses native HTTP client directly (M005E residual).",
},
LibraryEffectEntry {
name: "mongodb",
source_module: "libraries/mongodb",
register_fn: "register_mongodb_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "mqtt",
source_module: "libraries/mqtt",
register_fn: "register_mqtt_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct TCP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "msrpc",
source_module: "libraries/msrpc",
register_fn: "register_msrpc_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "msrpcperformance",
source_module: "libraries/msrpcperformance",
register_fn: "register_msrpcperformance_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "msrpctypes",
source_module: "libraries/msrpctypes",
register_fn: "register_msrpctypes_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure type definitions; no I/O.",
},
LibraryEffectEntry {
name: "mssql",
source_module: "libraries/mssql",
register_fn: "register_mssql_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "multicast",
source_module: "libraries/multicast",
register_fn: "register_multicast_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Unconnected/broadcast UDP; not brokered (M005E ungated).",
},
LibraryEffectEntry {
name: "mysql",
source_module: "libraries/mysql",
register_fn: "register_mysql_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "natpmp",
source_module: "libraries/natpmp",
register_fn: "register_natpmp_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Unconnected UDP send/recv; not brokered (M005E ungated).",
},
LibraryEffectEntry {
name: "nbd",
source_module: "libraries/nbd",
register_fn: "register_nbd_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "ncp",
source_module: "libraries/ncp",
register_fn: "register_ncp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "ndmp",
source_module: "libraries/ndmp",
register_fn: "register_ndmp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "netbios",
source_module: "libraries/netbios",
register_fn: "register_netbios_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "nmap",
source_module: "libraries/nmap",
register_fn: "register_nmap_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Lua-visible clock/random via broker; capability-aware process exec.",
},
LibraryEffectEntry {
name: "nrpc",
source_module: "libraries/nrpc",
register_fn: "register_nrpc_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "nse_string",
source_module: "libraries/nse_string",
register_fn: "register_nse_string_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure string helpers.",
},
LibraryEffectEntry {
name: "nse_table",
source_module: "libraries/nse_table",
register_fn: "register_nse_table_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure table helpers.",
},
LibraryEffectEntry {
name: "ntp",
source_module: "libraries/ntp",
register_fn: "register_ntp_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyAdvisory,
rationale: "Capability ctx present; UDP send/receive bypasses provider injection (M005E advisory).",
},
LibraryEffectEntry {
name: "omp2",
source_module: "libraries/omp2",
register_fn: "register_omp2_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: connect uses BrokeredTcpStream and the TLS handshake runs over that brokered stream.",
},
LibraryEffectEntry {
name: "oops",
source_module: "libraries/oops",
register_fn: "register_oops_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "openssl",
source_module: "libraries/openssl",
register_fn: "register_openssl_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: connects use BrokeredTcpStream and the TLS handshake runs over that brokered stream; no native handle escape.",
},
LibraryEffectEntry {
name: "oracle",
source_module: "libraries/oracle",
register_fn: "register_oracle_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "os",
source_module: "libraries/os",
register_fn: "register_os_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Env/time via brokers; some process exec residuals remain (manual-only under M007A).",
},
LibraryEffectEntry {
name: "ospf",
source_module: "libraries/ospf",
register_fn: "register_ospf_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Raw packet send/receive; outside provider contract (M005E ungated).",
},
LibraryEffectEntry {
name: "outlib",
source_module: "libraries/outlib",
register_fn: "register_outlib_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure output helpers.",
},
LibraryEffectEntry {
name: "packet",
source_module: "libraries/packet",
register_fn: "register_packet_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Raw packet send/receive; outside provider contract (M005E ungated).",
},
LibraryEffectEntry {
name: "pcre",
source_module: "libraries/pcre",
register_fn: "register_pcre_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure regular expressions.",
},
LibraryEffectEntry {
name: "pgsql",
source_module: "libraries/pgsql",
register_fn: "register_pgsql_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "pop3",
source_module: "libraries/pop3",
register_fn: "register_pop3_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "postgres",
source_module: "libraries/postgres",
register_fn: "register_postgres_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: struct-held stream and blocking connect use BrokeredTcpStream; spawn_blocking async aliases call the brokered path.",
},
LibraryEffectEntry {
name: "pppoe",
source_module: "libraries/pppoe",
register_fn: "register_pppoe_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "proxy",
source_module: "libraries/proxy",
register_fn: "register_proxy_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "punycode",
source_module: "libraries/punycode",
register_fn: "register_punycode_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure Punycode encoding.",
},
LibraryEffectEntry {
name: "radius",
source_module: "libraries/radius",
register_fn: "register_radius_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B corrective: connect_async uses broker_udp_connect; the raw tokio UdpSocket bind+connect the audit found is gone, so the module is promoted. The remaining entries are pure stubs.",
},
LibraryEffectEntry {
name: "rand",
source_module: "libraries/rand",
register_fn: "register_rand_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Random via broker_random_fill (provider-backed).",
},
LibraryEffectEntry {
name: "rdp",
source_module: "libraries/rdp",
register_fn: "register_rdp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "re",
source_module: "libraries/re",
register_fn: "register_re_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure regex helpers.",
},
LibraryEffectEntry {
name: "redis",
source_module: "libraries/redis",
register_fn: "register_redis_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "rmi",
source_module: "libraries/rmi",
register_fn: "register_rmi_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "rpc",
source_module: "libraries/rpc",
register_fn: "register_rpc_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct UDP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "rpcap",
source_module: "libraries/rpcap",
register_fn: "register_rpcap_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "rsync",
source_module: "libraries/rsync",
register_fn: "register_rsync_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "rtsp",
source_module: "libraries/rtsp",
register_fn: "register_rtsp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "sasl",
source_module: "libraries/sasl",
register_fn: "register_sasl_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct TCP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "sftp",
source_module: "libraries/sftp",
register_fn: "register_sftp_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Native SSH handle handoff; not brokered (M005E ungated).",
},
LibraryEffectEntry {
name: "shortport",
source_module: "libraries/shortport",
register_fn: "register_shortport_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure port normalization.",
},
LibraryEffectEntry {
name: "sip",
source_module: "libraries/sip",
register_fn: "register_sip_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "slaxml",
source_module: "libraries/slaxml",
register_fn: "register_slaxml_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure XML builder/parser.",
},
LibraryEffectEntry {
name: "smb",
source_module: "libraries/smb",
register_fn: "register_smb_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: internal TcpStream plumbing plus async aliases use BrokeredTcpStream; no direct socket effect remains.",
},
LibraryEffectEntry {
name: "smb2",
source_module: "libraries/smb2",
register_fn: "register_smb2_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "smbauth",
source_module: "libraries/smbauth",
register_fn: "register_smbauth_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Auth helper; no Lua-bound capability consultation (M005E residual).",
},
LibraryEffectEntry {
name: "smtp",
source_module: "libraries/smtp",
register_fn: "register_smtp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "snmp",
source_module: "libraries/snmp",
register_fn: "register_snmp_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyAdvisory,
rationale: "Capability ctx present; BER encode/decode + UDP send/recv bypass provider injection (M005E advisory).",
},
LibraryEffectEntry {
name: "socket",
source_module: "libraries/socket",
register_fn: "register_socket_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "TCP/UDP via broker_tcp_connect / broker_udp_connect; capability + sandbox aware.",
},
LibraryEffectEntry {
name: "socks",
source_module: "libraries/socks",
register_fn: "register_socks_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "srvloc",
source_module: "libraries/srvloc",
register_fn: "register_srvloc_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct UDP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "ssh",
source_module: "libraries/ssh",
register_fn: "register_ssh_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyAdvisory,
rationale: "Capability ctx consulted; native SSH framing uses direct I/O (M005E advisory).",
},
LibraryEffectEntry {
name: "ssh1",
source_module: "libraries/ssh1",
register_fn: "register_ssh1_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "ssh2",
source_module: "libraries/ssh2",
register_fn: "register_ssh2_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Stub-only registration; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "sslcert",
source_module: "libraries/sslcert",
register_fn: "register_sslcert_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: connect uses BrokeredTcpStream and the TLS handshake runs over that brokered stream.",
},
LibraryEffectEntry {
name: "sslv2",
source_module: "libraries/sslv2",
register_fn: "register_sslv2_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "stdnse",
source_module: "libraries/stdnse",
register_fn: "register_stdlib_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Time/random via brokers; capabilities consulted for sleep/etc.",
},
LibraryEffectEntry {
name: "strbuf",
source_module: "libraries/strbuf",
register_fn: "register_strbuf_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure string buffer.",
},
LibraryEffectEntry {
name: "stringaux",
source_module: "libraries/stringaux",
register_fn: "register_stringaux_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure string utilities.",
},
LibraryEffectEntry {
name: "stun",
source_module: "libraries/stun",
register_fn: "register_stun_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Unconnected UDP send/recv; not brokered (M005E ungated).",
},
LibraryEffectEntry {
name: "tab",
source_module: "libraries/tab",
register_fn: "register_tab_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure table utilities.",
},
LibraryEffectEntry {
name: "tableaux",
source_module: "libraries/tableaux",
register_fn: "register_tableaux_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure table inspection.",
},
LibraryEffectEntry {
name: "target",
source_module: "libraries/target",
register_fn: "register_target_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Pure host parsing helpers.",
},
LibraryEffectEntry {
name: "telnet",
source_module: "libraries/telnet",
register_fn: "register_telnet_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct TCP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "tftp",
source_module: "libraries/tftp",
register_fn: "register_tftp_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Unconnected UDP send/recv; not brokered (M005E ungated).",
},
LibraryEffectEntry {
name: "tls",
source_module: "libraries/tls",
register_fn: "register_tls_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: connect uses BrokeredTcpStream and the TLS handshake runs over that brokered stream; connect_tcp stays capability-gated.",
},
LibraryEffectEntry {
name: "tn3270",
source_module: "libraries/tn3270",
register_fn: "register_tn3270_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "tns",
source_module: "libraries/tns",
register_fn: "register_tns_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "unicode",
source_module: "libraries/unicode",
register_fn: "register_unicode_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure Unicode helpers.",
},
LibraryEffectEntry {
name: "unittest",
source_module: "libraries/unittest",
register_fn: "register_unittest_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure test framework.",
},
LibraryEffectEntry {
name: "unpwdb",
source_module: "libraries/unpwdb",
register_fn: "register_unpwdb_library",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Filesystem reads via nse_fs_read_to_string; capability-gated.",
},
LibraryEffectEntry {
name: "upnp",
source_module: "libraries/upnp",
register_fn: "register_upnp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: SSDP/SOAP TCP paths use BrokeredTcpStream and description fetch uses broker_http_request; no direct socket effect remains.",
},
LibraryEffectEntry {
name: "url",
source_module: "libraries/url",
register_fn: "register_url_library",
eligibility: NseAutomatedLibraryEligibility::Pure,
rationale: "Pure URL parsing.",
},
LibraryEffectEntry {
name: "versant",
source_module: "libraries/versant",
register_fn: "register_versant_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "vnc",
source_module: "libraries/vnc",
register_fn: "register_vnc_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: struct-held streams and blocking connects use BrokeredTcpStream; async aliases call the brokered path directly.",
},
LibraryEffectEntry {
name: "vulns",
source_module: "libraries/vulns",
register_fn: "register_vulns_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "CVE lookups (NVD/OSV/CISA) via broker_http_request.",
},
LibraryEffectEntry {
name: "vuzedht",
source_module: "libraries/vuzedht",
register_fn: "register_vuzedht_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct UDP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "websocket",
source_module: "libraries/websocket",
register_fn: "register_websocket_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Async Tokio I/O; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "whois",
source_module: "libraries/whois",
register_fn: "register_whois_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Direct TCP framing; no capability ctx (M005E ungated).",
},
LibraryEffectEntry {
name: "winrm",
source_module: "libraries/winrm",
register_fn: "register_winrm_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "wsdd",
source_module: "libraries/wsdd",
register_fn: "register_wsdd_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyDirectIo,
rationale: "Unconnected/broadcast UDP send/recv; not brokered (M005E ungated).",
},
LibraryEffectEntry {
name: "xdmcp",
source_module: "libraries/xdmcp",
register_fn: "register_xdmcp_library",
eligibility: NseAutomatedLibraryEligibility::ManualOnlyAdvisory,
rationale: "Capability ctx present; UDP send/recv bypass provider injection (M005E advisory).",
},
LibraryEffectEntry {
name: "xmpp",
source_module: "libraries/xmpp",
register_fn: "register_xmpp_library_with_services",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "M007B: broker-compatible TCP paths fully migrated to BrokeredTcpStream (broker_tcp_connect/send/receive); no direct socket effect remains.",
},
LibraryEffectEntry {
name: "zlib",
source_module: "libraries/zlib",
register_fn: "register_zlib_library",
eligibility: NseAutomatedLibraryEligibility::ProviderBacked,
rationale: "Compression brokered via nse_compress / nse_decompress; capability-gated.",
},
];
pub fn classify(name: &str) -> Option<&'static LibraryEffectEntry> {
LIBRARY_EFFECT_MANIFEST
.binary_search_by(|e| e.name.cmp(name))
.ok()
.map(|idx| &LIBRARY_EFFECT_MANIFEST[idx])
}
pub fn automated_library_eligibility(name: &str) -> NseAutomatedLibraryEligibility {
classify(name)
.map(|e| e.eligibility)
.unwrap_or(NseAutomatedLibraryEligibility::ManualOnlyDirectIo)
}
pub fn is_automated_library_safe(name: &str, profile: NseExecutionProfileKind) -> bool {
eligible_for_profile(name, profile)
}
pub fn eligible_for_profile(name: &str, profile: NseExecutionProfileKind) -> bool {
let eligibility = automated_library_eligibility(name);
match profile {
NseExecutionProfileKind::ManualPermissive
| NseExecutionProfileKind::ManualStrict
| NseExecutionProfileKind::CompatibilityLab => true,
NseExecutionProfileKind::AgentSafe | NseExecutionProfileKind::CiSafe => {
matches!(
eligibility,
NseAutomatedLibraryEligibility::Pure
| NseAutomatedLibraryEligibility::ProviderBacked
)
}
}
}
pub fn is_automated_profile(profile: NseExecutionProfileKind) -> bool {
matches!(
profile,
NseExecutionProfileKind::AgentSafe | NseExecutionProfileKind::CiSafe
)
}
pub fn classified_libraries() -> &'static [LibraryEffectEntry] {
LIBRARY_EFFECT_MANIFEST
}
pub fn eligibility_counts() -> EligibilityCounts {
let mut counts = EligibilityCounts::default();
for entry in LIBRARY_EFFECT_MANIFEST {
match entry.eligibility {
NseAutomatedLibraryEligibility::Pure => counts.pure += 1,
NseAutomatedLibraryEligibility::ProviderBacked => counts.provider_backed += 1,
NseAutomatedLibraryEligibility::ManualOnlyDirectIo => counts.manual_only_direct_io += 1,
NseAutomatedLibraryEligibility::ManualOnlyAdvisory => counts.manual_only_advisory += 1,
}
}
counts
}
#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
pub struct EligibilityCounts {
pub pure: usize,
pub provider_backed: usize,
pub manual_only_direct_io: usize,
pub manual_only_advisory: usize,
}
impl EligibilityCounts {
pub fn total(&self) -> usize {
self.pure + self.provider_backed + self.manual_only_direct_io + self.manual_only_advisory
}
pub fn automated_safe(&self) -> usize {
self.pure + self.provider_backed
}
pub fn manual_only(&self) -> usize {
self.manual_only_direct_io + self.manual_only_advisory
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn manifest_is_sorted_and_unique() {
let mut last: Option<&'static str> = None;
let mut seen = std::collections::BTreeSet::new();
for entry in LIBRARY_EFFECT_MANIFEST {
if let Some(prev) = last {
assert!(
prev < entry.name,
"manifest must be sorted; '{}' should come after '{}'",
entry.name,
prev
);
}
last = Some(entry.name);
assert!(
seen.insert(entry.name),
"duplicate entry name '{}' in manifest",
entry.name
);
}
}
#[test]
fn every_entry_has_source_and_rationale() {
for entry in LIBRARY_EFFECT_MANIFEST {
assert!(
!entry.source_module.is_empty(),
"entry '{}' missing source_module",
entry.name
);
assert!(
!entry.register_fn.is_empty(),
"entry '{}' missing register_fn",
entry.name
);
assert!(
!entry.rationale.is_empty(),
"entry '{}' missing rationale",
entry.name
);
}
}
#[test]
fn eligibility_display_matches_variants() {
assert_eq!(NseAutomatedLibraryEligibility::Pure.to_string(), "Pure");
assert_eq!(
NseAutomatedLibraryEligibility::ProviderBacked.to_string(),
"ProviderBacked"
);
assert_eq!(
NseAutomatedLibraryEligibility::ManualOnlyDirectIo.to_string(),
"ManualOnlyDirectIo"
);
assert_eq!(
NseAutomatedLibraryEligibility::ManualOnlyAdvisory.to_string(),
"ManualOnlyAdvisory"
);
}
#[test]
fn profile_gating_matches_spec() {
let pure = "base64";
let provider_backed = "http";
let manual_advisory = "snmp";
let manual_direct = "tftp";
for profile in [
NseExecutionProfileKind::ManualPermissive,
NseExecutionProfileKind::ManualStrict,
NseExecutionProfileKind::CompatibilityLab,
] {
assert!(eligible_for_profile(pure, profile));
assert!(eligible_for_profile(provider_backed, profile));
assert!(eligible_for_profile(manual_advisory, profile));
assert!(eligible_for_profile(manual_direct, profile));
}
for profile in [
NseExecutionProfileKind::AgentSafe,
NseExecutionProfileKind::CiSafe,
] {
assert!(eligible_for_profile(pure, profile));
assert!(eligible_for_profile(provider_backed, profile));
assert!(!eligible_for_profile(manual_advisory, profile));
assert!(!eligible_for_profile(manual_direct, profile));
}
}
#[test]
fn unknown_library_fails_closed() {
for profile in [
NseExecutionProfileKind::AgentSafe,
NseExecutionProfileKind::CiSafe,
] {
assert!(
!eligible_for_profile("not_in_manifest", profile),
"unknown names must be manual-only under automated profiles"
);
}
assert!(eligible_for_profile(
"not_in_manifest",
NseExecutionProfileKind::ManualPermissive
));
assert!(eligible_for_profile(
"not_in_manifest",
NseExecutionProfileKind::ManualStrict
));
assert!(eligible_for_profile(
"not_in_manifest",
NseExecutionProfileKind::CompatibilityLab
));
}
#[test]
fn manifest_covers_known_key_libraries() {
for name in [
"stdnse", "nmap", "http", "dns", "comm", "socket", "io", "os", "lfs", "smb", "pop3",
"ftp", "ssh", "sslcert", "tls",
] {
assert!(
classify(name).is_some(),
"library '{}' must have a manifest entry",
name
);
}
}
#[test]
fn counts_make_sense() {
let counts = eligibility_counts();
assert_eq!(
counts.total(),
LIBRARY_EFFECT_MANIFEST.len(),
"eligibility_counts() must cover every manifest entry"
);
assert_eq!(
counts.automated_safe() + counts.manual_only(),
counts.total(),
"every entry is either automated-safe or manual-only"
);
assert!(
counts.automated_safe() >= 110,
"expected at least 110 automated-safe entries after the M007B promotion, got {}",
counts.automated_safe()
);
assert!(
counts.manual_only() >= 40,
"expected at least 40 manual-only entries (unresolved residual), got {}",
counts.manual_only()
);
}
#[test]
fn automated_profile_predicate_is_correct() {
assert!(is_automated_profile(NseExecutionProfileKind::AgentSafe));
assert!(is_automated_profile(NseExecutionProfileKind::CiSafe));
assert!(!is_automated_profile(
NseExecutionProfileKind::ManualPermissive
));
assert!(!is_automated_profile(NseExecutionProfileKind::ManualStrict));
assert!(!is_automated_profile(
NseExecutionProfileKind::CompatibilityLab
));
}
fn registered_pairs() -> std::collections::BTreeMap<String, String> {
let source = include_str!("executor_core.rs");
let body = source
.split_once("fn register_libraries(&self)")
.expect("register_libraries() must exist in executor_core.rs")
.1;
let mut pairs = std::collections::BTreeMap::new();
for line in body.lines() {
let Some(rest) = line.split("crate::libraries::").nth(1) else {
continue;
};
let Some((module, call)) = rest.split_once("::") else {
continue;
};
let call = call.trim_start();
if !call.starts_with("register_") {
continue;
}
let Some((fn_name, tail)) = call.split_once(['(', ' ']) else {
continue;
};
if tail.contains(')') && !call.contains('(') {
continue;
}
pairs
.entry(module.to_string())
.or_insert_with(|| fn_name.to_string());
}
pairs
}
fn registration_compat_entries() -> std::collections::BTreeSet<String> {
include_str!("../scripts/nse-registration-compat-entries.txt")
.lines()
.filter(|l| !l.trim_start().starts_with('#') && !l.trim().is_empty())
.filter_map(|l| l.split_whitespace().next())
.map(|s| s.to_string())
.collect()
}
#[test]
fn registration_and_manifest_agree() {
let registered = registered_pairs();
let mut matched = std::collections::BTreeSet::new();
for entry in LIBRARY_EFFECT_MANIFEST {
let Some(module) = entry.source_module.strip_prefix("libraries/") else {
continue;
};
let Some(actual_fn) = registered.get(module) else {
continue;
};
assert_eq!(
entry.register_fn, actual_fn,
"manifest entry '{}' records register_fn '{}' but executor_core.rs calls '{}'",
entry.name, entry.register_fn, actual_fn
);
assert!(
matched.insert(module.to_string()),
"module '{}' is claimed by more than one manifest entry",
module
);
}
for module in registered.keys() {
assert!(
matched.contains(module),
"registered module '{}' has no effect-manifest entry",
module
);
}
let compat = registration_compat_entries();
for entry in LIBRARY_EFFECT_MANIFEST {
let Some(module) = entry.source_module.strip_prefix("libraries/") else {
continue;
};
if registered.contains_key(module) {
continue;
}
let path = format!("src/libraries/{module}.rs");
assert!(
compat.contains(&path),
"manifest entry '{}' ({}) is not registered and is not listed in \
scripts/nse-registration-compat-entries.txt",
entry.name,
path
);
}
for path in &compat {
let file = path
.strip_prefix("src/libraries/")
.and_then(|p| p.strip_suffix(".rs"));
let Some(module) = file else {
panic!("compat entry '{path}' must be a src/libraries/<module>.rs path");
};
assert!(
!registered.contains_key(module),
"compat entry '{path}' is now registered; remove it from the allowlist"
);
}
}
#[test]
fn m005e_baseline_keeps_exactly_one_class() {
let baseline: std::collections::BTreeSet<&str> =
include_str!("../scripts/nse-m005e-direct-io-baseline.txt")
.lines()
.filter(|l| !l.trim_start().starts_with('#') && !l.trim().is_empty())
.collect();
assert_eq!(
baseline.len(),
97,
"the M005E baseline must stay frozen at 97 files"
);
let mut classified: std::collections::BTreeMap<&str, usize> =
std::collections::BTreeMap::new();
for line in include_str!("../scripts/nse-migration-classes.txt").lines() {
if line.trim_start().starts_with('#') || line.trim().is_empty() {
continue;
}
*classified
.entry(line.split_whitespace().next().unwrap())
.or_default() += 1;
}
for path in &baseline {
let count = classified
.get(path)
.unwrap_or_else(|| panic!("M005E baseline entry {path} lost its migration class"));
assert_eq!(
*count, 1,
"M005E baseline entry {path} must have exactly one class, found {count}"
);
}
}
#[test]
fn migrated_cohort_is_promoted_to_provider_backed() {
const PROMOTED: &[&str] = &[
"afp",
"ajp",
"amqp",
"anyconnect",
"bitcoin",
"bittorrent",
"brute",
"cassandra",
"citrixxml",
"cvs",
"dicom",
"drda",
"ftp",
"iec61850mms",
"imap",
"informix",
"ipp",
"irc",
"iscsi",
"isns",
"jdwp",
"ldap",
"membase",
"memcached",
"mongodb",
"msrpc",
"msrpcperformance",
"mssql",
"mysql",
"nbd",
"ncp",
"ndmp",
"netbios",
"nrpc",
"omp2",
"oops",
"openssl",
"oracle",
"pgsql",
"pop3",
"postgres",
"proxy",
"rdp",
"redis",
"rmi",
"rpcap",
"rsync",
"rtsp",
"sip",
"smb",
"smb2",
"smtp",
"socks",
"ssh1",
"sslcert",
"sslv2",
"target",
"tls",
"tn3270",
"tns",
"upnp",
"versant",
"vnc",
"winrm",
"xmpp",
];
for name in PROMOTED {
let entry = classify(name)
.unwrap_or_else(|| panic!("promoted library '{name}' must have a manifest entry"));
assert_eq!(
entry.eligibility,
NseAutomatedLibraryEligibility::ProviderBacked,
"'{name}' is in the M007B promoted cohort but is not ProviderBacked"
);
assert!(
eligible_for_profile(name, NseExecutionProfileKind::AgentSafe),
"'{name}' must be reachable under AgentSafe after promotion"
);
}
}
#[test]
fn unresolved_residual_stays_manual_only() {
const RESIDUAL: &[&str] = &[
"bjnp", "coap", "dhcp", "dhcp6", "eigrp", "iax2", "ike", "ipmi", "knx", "libssh2",
"natpmp", "ntp", "packet", "snmp", "srvloc", "ssh", "ssh2", "stun", "tftp", "wsdd",
"xdmcp",
];
for name in RESIDUAL {
let entry = classify(name)
.unwrap_or_else(|| panic!("residual library '{name}' must have a manifest entry"));
assert!(
matches!(
entry.eligibility,
NseAutomatedLibraryEligibility::ManualOnlyDirectIo
| NseAutomatedLibraryEligibility::ManualOnlyAdvisory
),
"'{name}' still has a direct host network effect and must stay manual-only, got {}",
entry.eligibility
);
for profile in [
NseExecutionProfileKind::AgentSafe,
NseExecutionProfileKind::CiSafe,
] {
assert!(
!eligible_for_profile(name, profile),
"'{name}' must not be reachable under {profile:?}"
);
}
}
}
}