From cbc6d57012c7ae812f4ef7ea6aade5be2402596f Mon Sep 17 00:00:00 2001 From: Shengqi Chen Date: Wed, 3 Sep 2025 23:49:34 +0800 Subject: [PATCH] Add upcoming renaming notice for arc_summary and arcstat They will become zarcsummary and zarcstat in 2.4.0. Reviewed-by: Brian Behlendorf Reviewed-by: Tony Hutter Signed-off-by: Shengqi Chen Closes #16357 Closes #17695 --- cmd/arc_summary | 7 +++++++ cmd/arcstat.in | 9 +++++++++ man/man1/arcstat.1 | 2 ++ 3 files changed, 18 insertions(+) diff --git a/cmd/arc_summary b/cmd/arc_summary index e60c6b64e..9538dd599 100755 --- a/cmd/arc_summary +++ b/cmd/arc_summary @@ -1021,6 +1021,13 @@ def main(): treated separately because they come with their own call. """ + # notify user for upcoming renaming in 2.4.0 + abs_path = os.path.abspath(sys.argv[0].strip()) + script_name = os.path.basename(abs_path) + if script_name != "zarcsummary": + sys.stderr.write("Note: this script will be renamed to zarcsummary in ") + sys.stderr.write("zfs 2.4.0. Please migrate ASAP.\n") + kstats = get_kstats() if ARGS.graph: diff --git a/cmd/arcstat.in b/cmd/arcstat.in index 6f9abb39c..e153eddb3 100755 --- a/cmd/arcstat.in +++ b/cmd/arcstat.in @@ -56,6 +56,7 @@ import time import getopt import re import copy +import os from signal import signal, SIGINT, SIGWINCH, SIG_DFL @@ -766,6 +767,14 @@ def calculate(): def main(): + + # notify user for upcoming renaming in 2.4.0 + abs_path = os.path.abspath(sys.argv[0].strip()) + script_name = os.path.basename(abs_path) + if script_name != "zarcstat": + sys.stderr.write("Note: this script will be renamed to zarcstat in ") + sys.stderr.write("zfs 2.4.0. Please migrate ASAP.\n") + global sint global count global hdr_intr diff --git a/man/man1/arcstat.1 b/man/man1/arcstat.1 index fe2e0407e..288b98d57 100644 --- a/man/man1/arcstat.1 +++ b/man/man1/arcstat.1 @@ -20,6 +20,8 @@ .Sh NAME .Nm arcstat .Nd report ZFS ARC and L2ARC statistics +.Sh NOTICE +It will be renamed to zarcstat in zfs 2.4.0. Please migrate ASAP. .Sh SYNOPSIS .Nm .Op Fl havxp