{"record":{"id":"913990c6e01c0c85","repo":"shadowsocks/shadowsocks-rust","slug":"unix-datagram-requires-path-address-target","errorCode":null,"errorMessage":"unix datagram requires path address target","messagePattern":"unix datagram requires path address target","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"crates/shadowsocks/src/manager/datagram.rs","lineNumber":162,"sourceCode":"            Self::UdpDatagram(ref mut udp) => match *target {\n                ManagerSocketAddr::SocketAddr(ref saddr) => udp.send_to(buf, saddr).await,\n                #[cfg(unix)]\n                ManagerSocketAddr::UnixSocketAddr(..) => {\n                    let err = io::Error::new(ErrorKind::InvalidInput, \"udp datagram requires IP address target\");\n                    Err(err)\n                }\n            },\n            #[cfg(unix)]\n            Self::UnixDatagram(ref mut unix) => match *target {\n                ManagerSocketAddr::UnixSocketAddr(ref saddr) => match saddr.as_pathname() {\n                    Some(paddr) => unix.send_to(buf, paddr).await,\n                    None => {\n                        let err = io::Error::new(ErrorKind::InvalidInput, \"target address must not be unnamed\");\n                        Err(err)\n                    }\n                },\n                ManagerSocketAddr::SocketAddr(..) => {\n                    let err = io::Error::new(ErrorKind::InvalidInput, \"unix datagram requires path address target\");\n                    Err(err)\n                }\n            },\n        }\n    }\n\n    /// Sends data on the socket to the specified manager address\n    pub async fn send_to_manager(&mut self, buf: &[u8], context: &Context, target: &ManagerAddr) -> io::Result<usize> {\n        match *self {\n            Self::UdpDatagram(ref mut udp) => match *target {\n                ManagerAddr::SocketAddr(ref saddr) => udp.send_to(buf, saddr).await,\n                ManagerAddr::DomainName(ref dname, port) => {\n                    let (_, n) = lookup_then!(context, dname, port, |saddr| { udp.send_to(buf, saddr).await })?;\n                    Ok(n)\n                }\n                #[cfg(unix)]\n                ManagerAddr::UnixSocketAddr(..) => {\n                    let err = io::Error::new(ErrorKind::InvalidInput, \"udp datagram requires IP address target\");","sourceCodeStart":144,"sourceCodeEnd":180,"githubUrl":"https://github.com/shadowsocks/shadowsocks-rust/blob/8eb0f0a65b1d976ab6bed5787327ef86529b0435/crates/shadowsocks/src/manager/datagram.rs#L144-L180","documentation":"send_to on a unix-datagram manager socket was given an IP:port (ManagerSocketAddr::SocketAddr) target. Unix datagram sockets can only send to path-based addresses, so the call fails with ErrorKind::InvalidInput.","triggerScenarios":"Calling send_to with ManagerDatagram::UnixDatagram transport but a ManagerSocketAddr::SocketAddr target parsed from an IP:port string.","commonSituations":"Mixed-up configuration where the transport is a unix socket but the manager address in config is host:port; code paths shared between UDP and unix transports passing the wrong address variant.","solutions":["Pass a unix path address (ManagerSocketAddr::UnixSocketAddr) when using the unix datagram transport","Switch the transport to UDP if the manager really is reached via IP:port","Match the address type against the transport type before calling send_to"],"exampleFix":"// before\nunix_conn.send_to(buf, &ManagerSocketAddr::SocketAddr(ip_port)).await?;\n// after\nunix_conn.send_to(buf, &ManagerSocketAddr::UnixSocketAddr(unix_addr)).await?;","handlingStrategy":"validation","validationCode":"if let ManagerSocketAddr::SocketAddr(_) = target {\n    return Err(anyhow!(\"unix transport requires path target\"));\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Match address variant to transport (unix<->path, udp<->IP)","Validate manager config at startup, before sending"],"tags":["unix-socket","datagram","invalid-input","shadowsocks"],"backgroundTag":"invalid-argument-value","analyzedSha":"8eb0f0a65b1d976ab6bed5787327ef86529b0435","analyzedAt":"2026-09-09T12:20:43.168Z","contentChangedAt":"2026-09-09T12:20:43.168Z","schemaVersion":2},"datasetVersion":"2026-09-17T15:17:12.973Z"}