XSTAT_FS_TEST(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 xstat_fs_test — the OpenAFS command reference page, but make it make sense 💖

okay bestie, so this is xstat_fs_test(1) from the AFS Command Reference, and ngl it's giving ✨server gossip✨ — it's literally the tool that pulls data collections out of the File Server process and shows you what's up.

🌸 NAME 🌸

xstat_fs_test — Displays data collections from the File Server process

🦋 SYNOPSIS 🦋

xstat_fs_test [initcmd] -fsname <file server name(s) to monitor>+
    -collID <collection(s) to fetch>+ [-onceonly]
    [-frequency <poll frequency, in seconds>]
    [-period <data collection time, in minutes>] [-debug] [-version]
[-help]

xstat_fs_test [initcmd] -fs <File Server name(s) to monitor>+
    -c <Collection(s) to fetch>+ [-o]
    [-fr <poll frequency, in seconds>]
    [-p <data collection time, in minutes>] [-d] [-version] [-h]

so like. two whole ways to say the same thing. the long forms and the short forms. pick your vibe. both ate. 💅

💅 DESCRIPTION 💅

The xstat_fs_test command tests the routines in the libxstat_fs.a library and displays the data collections associated with the File Server (the "fs" process). The command executes in the foreground.

⚠️ okay real talk bestie — this thing produces a large volume of output. like, a LOT. if you wanna save it for later analysis, direct it to a file. do not just let it scream into your terminal forever. 🔥

✨ OPTIONS ✨

  • initcmd — Accommodates the command's use of the AFS command parser, and is optional.
  • -fsname <file server name to monitor>+ — Specifies the fully qualified hostname of each file server machine for which to monitor the File Server process.
  • -collID <collection to fetch>+ — Specifies each data collection to return, which defines the type and amount of data the command interpreter gathers about the File Server. Data is returned in a predefined data structure.

There are four acceptable values:

  1. 0 — Provides profiling information about the numbers of times different internal File Server routines were called since the File Server started. This value is not currently implemented; it returns no data. (so… it's giving nothing. literally no data. just vibes.)
  2. 1 — Reports various internal performance statistics related to the File Server (for example, vnode cache entries and Rx protocol activity).
  3. 2 — Reports all of the internal performance statistics provided by the 1 setting, plus some additional, detailed performance figures about the File Server (for example, minimum, maximum, and cumulative statistics regarding File Server RPCs, how long they take to complete, and how many succeed).
  4. 3 — Reports File Server callback processing statistics since the File Server started, including the number of call of callbacks added (AddCallBack), the number of callbacks broken (BreakCallBacks), and the number of callback space reclaims (GetSomeSpaces).
  • -onceonly (short form: -o) — Gathers statistics just one time. Omit this flag to have the command continue to probe the Cache Manager for statistics at the frequency specified by the -frequency argument; in this case press Ctrl+C to stop the probes.
  • -frequency <poll frequency> (short form: -fr) — Sets the frequency in seconds at which the program initiates probes to the Cache Manager. The default is 30 seconds.
  • -period <data collection time> (short form: -p) — Sets the number of minutes the program runs; at the end of this period of time, the program exits. The default is 10 minutes.
  • -debug (short form: -d) — Displays a trace on the standard output stream as the command runs.
  • -help (short form: -h) — Prints the online help for this command. All other valid options are ignored.
  • -version — Prints the program version and then exits. All other valid options are ignored.

🫶 SEE ALSO 🫶

xstat_cm_test(1)

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.

okay that's the whole page, no cap, every single flag intact 💖 and for the sign-off: this icon of a manpage is brought to you by OpenAFS, dated 2026-07-27, and it's filed under XSTAT_FS_TEST(1). go forth and poll responsibly, bestie 🌈⭐🎀

📦 where this page comes from