From nobody Wed May 21 06:44:52 2025 X-Original-To: dev-commits-src-all@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 4b2MNj0vlGz5wx24; Wed, 21 May 2025 06:44:53 +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 4b2MNh5PQGz4NVG; Wed, 21 May 2025 06:44:52 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1747809892; 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=WSXJjPf403oOfr3d7m8Uo6m+YarDPdHI/2GhoDQcoQA=; b=GYHZkPLr/dhMLqb0Er4kB4oEEVh9U0A7LIx3snEXCoc2se1sGTQmy6uhXhvCN9PXc9VYMb rngjDIGSqgYBriWjQUSamah62STe46q69UzV0oIIshy8S5cWZUXgijnL4EI44LUHzQMbj3 nnGdGpc8PzFc7/SVHfhDuP6+oyaqA4X8NXxEYbuHVS/+OPHH3Wet61MBA0RICYocZJ7P9Q qmkXIt+j4QLtZAG03U2e/bmDED8pCsrr7bjn2WrqXw8l20rF1nYTJmcn6KjtgM9ZGzZpPr GI01lZixyGz34dCcJZez23Fml1h7pQi3OC5fzsceRT4dQfyJLB+auobfw3C+AA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1747809892; 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=WSXJjPf403oOfr3d7m8Uo6m+YarDPdHI/2GhoDQcoQA=; b=THtERWtHDeaJqmic7fxDPKaDRGN4hLCu+tae4UbAOmdMVWnUUgEroXtLbI7ko5DTSEwToH kUXxjbfYJLWYH+go8IUHqCV5Ad/ra1SZXDR8dfD7Pf3117MNP0ZbWwNHzJNg+cusYK/0Un dHIqH45sENSw/AuuZwOmtHZTVIw9DQiD9uqmrYg32HxfWxo3f2PNLabAmKGviUFs1gcrUO kdncgpJtKqHSdrRyvLSM6mkAaBm5BqbfrW9A1WCUGlDbF4WpD1RCfsGUcNAqy2LiwZb89b Tf5Rzeg7d78V42GXH4X9FhTCSkwV+VmmbUbe33/4JPutIKe3+WwxAV6pEvvNXw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1747809892; a=rsa-sha256; cv=none; b=bg5nRbmx5kqvYlN5SAhf7TgXpizl63ZIyAXK5/LSh6iSm5C1pr+vXy8kKDzjCgzt0uUgxt SPGysKuul9Y2eanUGdSkn8ilbkS3M8afmPTiIXSGE7RrmRAdXnVwTG78qzaYvYMu3vIpuV p9vvOtU0lLW1zVZ63FzCCuni/B9QD8diFxNVvI6gNVrfuY2d/o8JPzMCdY5kNX7ThdkVVY 0mlydKktUgrdSuA0oH1rp/dGfwI7yytl7fnoQXIO+0SJgeyl0UalW5XfAyOPOipMuFvH6O 1y9Fv/aYcftsv1RpW1amORWGTfZXATnjLLjF4xozUhWeam/+7tGoG6FdXUoXqg== 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 4b2MNh3wFsz7my; Wed, 21 May 2025 06:44:52 +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 54L6iqZr034603; Wed, 21 May 2025 06:44:52 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 54L6iq4P034600; Wed, 21 May 2025 06:44:52 GMT (envelope-from git) Date: Wed, 21 May 2025 06:44:52 GMT Message-Id: <202505210644.54L6iq4P034600@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Lexi Winter Subject: git: a02915589dff - stable/14 - traceroute.8: improve the documentation of -P List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@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/stable/14 X-Git-Reftype: branch X-Git-Commit: a02915589dffa4b2eb93a686e430b35f7cbb10cc Auto-Submitted: auto-generated The branch stable/14 has been updated by ivy: URL: https://cgit.FreeBSD.org/src/commit/?id=a02915589dffa4b2eb93a686e430b35f7cbb10cc commit a02915589dffa4b2eb93a686e430b35f7cbb10cc Author: Lexi Winter AuthorDate: 2025-05-14 16:05:02 +0000 Commit: Lexi Winter CommitDate: 2025-05-21 06:29:17 +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 (cherry picked from commit 0829839fd0cd6046fbb5c0b6c6432b5ffe0d91e8) --- usr.sbin/traceroute/traceroute.8 | 64 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 63 insertions(+), 1 deletion(-) diff --git a/usr.sbin/traceroute/traceroute.8 b/usr.sbin/traceroute/traceroute.8 index 21427ef6e97c..6b46ec05a1c9 100644 --- a/usr.sbin/traceroute/traceroute.8 +++ b/usr.sbin/traceroute/traceroute.8 @@ -16,7 +16,7 @@ .\" $Id: traceroute.8,v 1.19 2000/09/21 08:44:19 leres Exp $ .\" $FreeBSD$ .\" -.Dd October 25, 2023 +.Dd May 14, 2025 .Dt TRACEROUTE 8 .Os .Sh NAME @@ -148,6 +148,68 @@ at the destination host (so an ICMP PORT_UNREACHABLE message will be returned 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 +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 +packets based on IP protocol number. +But see BUGS below. .It Fl q Ar nprobes Set the number of probes per hop (default is 3, unless