From nobody Thu May 15 00:04:18 2025 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4ZyVnH1fNxz5w1mk; Thu, 15 May 2025 00:04:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4ZyVnG6472z3qsr; Thu, 15 May 2025 00:04:18 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1747267458; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=1DLpWs/wRndaM5F6m/p4EsZ6e1jy96rPkFNmYRF+k38=; b=ERKwU3dw3UUX/wYs2RPEEIJLv2HmJ51t5+DFuofhXRUqwf8B0+ek+5YxjVPnwbVbYdoA4+ z4PVDA4+cAexyMrWssD9s8EwPCziDmmFd4OQYVh1Yxru48fjDlB64ywYVOZqesyX96gLYp ZeMafOf0q6+B6U4Wk1TSqrUEx9UGi79xpL7khX8RtdJMt1XdWYHIiUv5WSZyYHv59yAiVa B/MVMKYHeaN+O1TyXEX8YPaoa0ai2SdRaRCYi8VZlt61xATri1ho0zDfin6CJVUUx3Zbhl zHY0bhxqyCQ3YCwLdoGO1C9ObuuLp5Tvt0ip00KliRG55MzUUUlcDUJHtxEcQQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1747267458; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=1DLpWs/wRndaM5F6m/p4EsZ6e1jy96rPkFNmYRF+k38=; b=RHtfwRY4429bOqN3qNmitBsWh7B8J9WkS7cx2yA2YwIAiE/ZkTkiK/UOl3z9R/UFazfDTm YXc+GKSzo6ZqpCo9k6IBgjbPypOe1l1ckIDzVKzrkszDka4KVM+XM2cTMn45LfJX+S/U1z lWntA64W8lVsf6lBYo3e9MtBbcuVzufh+wJ6n6WsXr2AUIhppHvG5iH3sWLtWu4GNjg6vp Xla7yICTy0/lvMKr3yUOlhqRiw24AlqRaXzldVPMlNRQeRwVytMi6EJgxooNB5TY1RLN5S OFdsD1dJh6D9ar+Mf6FaA4qi6SNQIMg3313iwlQ0W+H8ui/qLB8hIdSsGrgmsA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1747267458; a=rsa-sha256; cv=none; b=qb9Kgr9cqFy6/S/V/Lg8Jr/tdxFeyILwWwiHMN79swCwPnhA1jzV0sF/TgWHp5NFg4JT6w u9zVF2wUSiRNvRLt1r/MiVe3t47Fav7jrdY5zf56IUbYgfgtR5vWXv1TRXUnirli4llXg5 9CGOriLFuG3xfGfzcfq66buUm6J6VHtO2dl4aB6a0iCXlHCk3OC6N5++eo1+PSNnqdl3ca VZmBsI57QPDv15wR+DXngFOMP9M1battUWALoxE+/bss3/iaX7o+LRPlbwlKGAhqnVCUz+ cZSB7np8HJ/sfZ8rIBikk34yb1smJS6aYdhVu0QrzbvolmYpaZXLQdud3ve7ZA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4ZyVnG5MLnzvDn; Thu, 15 May 2025 00:04:18 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 54F04Ils046996; Thu, 15 May 2025 00:04:18 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 54F04IKi046993; Thu, 15 May 2025 00:04:18 GMT (envelope-from git) Date: Thu, 15 May 2025 00:04:18 GMT Message-Id: <202505150004.54F04IKi046993@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Lexi Winter Subject: git: 0829839fd0cd - main - traceroute.8: improve the documentation of -P List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ivy X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 0829839fd0cd6046fbb5c0b6c6432b5ffe0d91e8 Auto-Submitted: auto-generated The branch main has been updated by ivy: URL: https://cgit.FreeBSD.org/src/commit/?id=0829839fd0cd6046fbb5c0b6c6432b5ffe0d91e8 commit 0829839fd0cd6046fbb5c0b6c6432b5ffe0d91e8 Author: Lexi Winter AuthorDate: 2025-05-14 16:05:02 +0000 Commit: Lexi Winter CommitDate: 2025-05-15 00:02:52 +0000 traceroute.8: improve the documentation of -P 1. -P didn't say what the argument is supposed to be; in the case of udplite(4), "-Pudp-lite" is not valid, one must use "-Pudplite". 2. be more explicit about what sort of packets we generate, particularly for -Psctp and -Pgre. Reviewed by: imp, tuexen, des Approved by: des (mentor) Pull Request: https://github.com/freebsd/freebsd-src/pull/1657 --- usr.sbin/traceroute/traceroute.8 | 62 ++++++++++++++++++++++++++++++++++++---- 1 file changed, 57 insertions(+), 5 deletions(-) diff --git a/usr.sbin/traceroute/traceroute.8 b/usr.sbin/traceroute/traceroute.8 index 203b743fb408..a97395944b2a 100644 --- a/usr.sbin/traceroute/traceroute.8 +++ b/usr.sbin/traceroute/traceroute.8 @@ -15,7 +15,7 @@ .\" .\" $Id: traceroute.8,v 1.19 2000/09/21 08:44:19 leres Exp $ .\" -.Dd November 17, 2023 +.Dd May 14, 2025 .Dt TRACEROUTE 8 .Os .Sh NAME @@ -136,10 +136,62 @@ to terminate the route tracing). If something is listening on a port in the default range, this option can be used to pick an unused port range. .It Fl P Ar proto -Send packets of specified IP protocol. -The currently supported protocols -are: UDP, UDP-Lite, TCP, SCTP, GRE and ICMP. -Other protocols may also be specified (either by name or by number), though +Use packets of specified IP protocol when sending probes. +The +.Ar proto +argument may be one of the following: +.Bl -tag -width Ar udplite +.It Ar udp +Use +.Xr udp 4 +packets. +This is the default. +.It Ar icmp +Use +.Xr icmp 4 +.Dq echo request +packets. +.It Ar udplite +Use +.Xr udplite 4 +packets. +.It Ar tcp +Use +.Xr tcp 4 +.Dq SYN +packets. +This will cause a successful traceroute to end with no response (i.e., a +.Dq * +response) since +.Nm +does not know how to detect the RST or SYN+ACK response from the +destination host. +.It Ar sctp +Use +.Xr sctp 4 +packets. +The +.Ar packetlen +argument must be a multiple of 4. +SCTP probes will be constructed as SCTP +.Dq INIT +chunks, unless the packet length is too small, in which case the probes +will be SCTP +.Dq SHUTDOWN-ACK +chunks followed by zero or one +.Dq PAD +chunks. +.It Ar gre +Use +.Xr gre 4 +packets. +The GRE packets will be constructed as if they contain a PPTP +(Point-to-Point Tunneling Protocol) payload. +.El +.Pp +Other protocols may also be specified, either by number or by name (see +.Xr protocols 5 ) , +though .Nm does not implement any special knowledge of their packet formats. This option is useful for determining which router along a path may be blocking