Skip to content

Clarify that sar column index may vary between sysstat versions - #221

Open
JWWTSL wants to merge 1 commit into
tenox7:masterfrom
JWWTSL:fix/sar-doc-column
Open

Clarify that sar column index may vary between sysstat versions#221
JWWTSL wants to merge 1 commit into
tenox7:masterfrom
JWWTSL:fix/sar-doc-column

Conversation

@JWWTSL

@JWWTSL JWWTSL commented Aug 3, 2026

Copy link
Copy Markdown

Summary

  • Clarify in the man page that the sar column index for %memused may vary between sysstat versions

Changes

File Change
ttyplot.1 Added note explaining column index variation and how to find the correct one

Details

The memory usage example uses @F[5] to extract %memused from sar -r output,
but this column index varies between sysstat versions and distributions
(e.g. Mint 21.2 uses @F[4]).

Added a note in the man page advising users to run sar -r 1 and count
the column containing %memused (starting from 0) to find the correct
index for their system.

Test Plan

  • man page renders correctly (.Nm, .Fl, .Ar, .Li macros used properly)
  • Verify man ./ttyplot.1 displays the new note correctly

Closes #167

The memory usage example uses @f[5] to extract %memused, but this
column index varies between sysstat versions and distributions.

Add a note explaining how to find the correct column index.

Closes tenox7#167
@JWWTSL
JWWTSL marked this pull request as ready for review August 3, 2026 03:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Shortcut for live plot of memory usage?

1 participant