-
In the last release
pcr_Xwould truncate formatted strings to 256 to match against the regexes. This release enlarges that to 2048 (~25 rows on an 80 column terminal!). Some limit seems prudent since command-lines can be much longer than this (e.g.**.c), yet proc types seem (to me) unlikely to be distinguished beyond a "small" prefix. We can enlarge a bit more or if no modest limit works for everyone add a CLI option to be user set.) -
Single->multi-char labels with ':' delimiter in labA:labB:PID on input & in output LABELS field. Field width here is a generous 30 so users can say, e.g.
pd -W$((COLUMNS+30) -f '%l..' ...| tslice:30to get nice text tables without losing any important external typing information.
Reconceive pcr0/pcrF feature of version 0.8.0 more generally. Now the
syntax pcr_? means "apply the perl-compatible regexes" to the "wide version"
formatted output of any of basic format code ? (from procs display help
table, like 'c' or 'C' or etc.). The old "bare pcr" remains as a backward
compatible shorthand for pcr_c. pcr_C replaces weeks old pcrF and
pcr0 is retired (one can probably do a good enough regex with a '^' anchor
in pcr_C to handle it, anyway).
Add 2 new codes:
- '@' for the `/proc/*/exe` symlink which may be the most reliable way to
group some process families but needs permissions (ie., normal user cannot
`readlink` root-owned `/proc/*/exe`).
- 'l' that emits newly "passed through" prefixes given by the user on the
command-line. Together with the newly ignore prefixes to pids, this
allows "fully external" proc classifying to be "imported" into the procs
"type system" for display by `pcr_l` matching whatever label/tag you gave
the process by your external algorithm. This import can be useful for
either colorization or merges/roll-ups, as per usual typology here.
Add a simple bench.sh script showing both relevant results for this design &
another eg. of bu/tim.md
delivering time measurements with low single digit microsecond errors (which
reproduce within error bars for me, re-running bench.sh on the same machine).
{ Of course, when pk (aka procs find -ak) speed matters most, "scheduler
time dilation" can stretch milliseconds out to seconds and beyond. So, this
has actually made a real difference in my life with, e.g. rogue nimsuggest
instances trying to use all RAM past the point of swapping and so on. }
Add procs find --otrTerm (aka pf -O) to terminate PID lists.
Use delim & otrTerm more consistently so that output is better framed /
separable even without labeling. This is ~BREAKING. E.g. /proc/$(pf foo)/X
now gets a space breaking the path, since pf does know how many PIDs will be
printed in advance. However, special cases like --first|--oldest|--newest
turn delim to "" so /proc/$(pf -o foo)/X works as before. Further, as
before in Zsh, this still works: ls -ld /proc/$(pf -d\| zsh)/cwd.
Big bug fix for procs find aka pf where a reused object had stale data.
At the library level, add & export Proc.clear if others want to use this.
Use /proc/sys/kernel/pid_max to tell how many decimals PIDs can be & yield
more reliable "tabular shape" across Linux setups.
Add pcr0 & pcrF kind match operators to match against either $argv[0] or
the fully joined $argv for purposes of user-defined roll-ups.
Explicit lists of PIDs with duplicates no longer duplicate output rows.
New %A = AncestorID format specifier.
Two new actions for pf to help restrict the report:
- path { parent(parent(...())) reversed } for more focused ancestry.
- aid for ancestor id / whole family tree selection
An e.g. of the first - report on the PPID(PPID(..)) "path" of any proc whose
(command) contains "nvim": pd -sb $(pf -ap '\bnvim\b'). A more involved
wrapper of the second, assuming style A* begins with the new %A, reports
whole family trees for all commands with the grep pattern in $1:
# NOTE: \\bPAT will NOT match itself; E.g. puf \\bsh
: "${pf=-f}" # E.g.s: `pf=`, `pf="-f -x$$"`
: "${g:=grep --color=always}" # grep with any extra flags
: "${d:=`wc -c </proc/sys/kernel/pid_max`}" # PID digs + 1colSep space
COLUMNS=$((COLUMNS+d)) pd -sA | # Assume style A* starts with %A
$g '^\(^[\[[0-9;]*m\)*\<\('$(pf -aa -d'\|' $pf $1)AID'\)\>\|'"$1" |
tslice $d: # New `bu/tslice` utilityJust pretty minor/dumb edits & .nimble dependency updates
Fix `schedStat` spelling (hitherto undetected since `styleCheck=usages styleCheck=error` does not work unless `hint[Name]=on` is also set).
Add option to preface each sample in differential-delay mode with time.
Add a built-in type "self" for the procs display process itself.
This can be nice either to suppress it, say in
`procs display --delay=0.001 --excl=self`
or to emphasize it (e.g. to know which tty ran program in tree formats) with
special colorization.
Update example color config, correctly renumbering side-comment slots and
default to struck (& probably bold, unlike zombies).
Add one flavor of mUsed for `scrollsy` - total-complement to mAvl.
Right align headers for right aligned fields
Rename NI -> NICE; F -> FLAGS; Abbreviation unhelpful
TTY -> TT & 2-column format to save a terminal column in the common case.
Add new parts per billion CPU time usage as %b; Update
configs/cb0/style.auser to use it.
Give 2 new ways to test for existence of any matches:
- `pf -e STUFF || start-it`
- `pf -ac STUFF >/dev/null || start-it`
Bump minor since this adds an important new use case (though, arguably, so
did nanosecond time stamps).
Fix bug converting delay TimeSpec from seconds to jiffies
Fix longstanding environ 'e' masks %cPU 'e' bug
Rely upon `cligen/puSig` for posix/unix signal names.
Add PSS (proportional set size) keyed by 'M' / "%M".
Handle formatting negative numbers better (for differential mode).
Add nanosecond time stamp field for high-resolution logs
Add --blanks for differential report readability (esp. w/no header row..)
Just for cligen dependency version bump.
silence some `mm:arc` performance warnings.
Update default distributed style to have %a (age) as well as used %Jiffies.
Work around long-present crash in differential mode if compiled in mm:arc
mode via `template forPid`.
Speed up `procs find` by 1.25x via cligen/mslice number parsers.
Add some real installer-script logic to procs.nimble.
Better help. Add text attr help dump to version text.
Improve default distributed configs.
Fix bad bug in newest/oldest
Add `--age` to `pf`; Make --actions take -a name; `--age` take `-A`.
Add --limit feature to time out existence checks in wait* actions.
Just dep/nimble futzing.
Clean-compile/de-warnification & do pty not tty in `ttyToDev`.
Nicer Control-C exits
Emphasize the 'v' in requested "invert" `procs find`/`pf` feature.
Extend find/act/kill self-avoidance to own whole process group.
Make back/forward compatible with nimPreviewSlimSystem
Quieter exit upon Control-C in all subprograms. (This could arguably be
a cligen feature adjustable by end CLusers, like SIGPIPE behavior.)
Extend -xPPID self killing/acting-avoidance to include own process group.
Add -i flag to `pf` to force pattern insensitivity { (?i) added to start of
every pattern as per lib/impure/nre.nim documentation. Seems to work fine. }
Make `pw` less chatty (only ^C not default Nim message), but still
exit 130 in case there is some `pw patterns &&` shell construct.
For example config, add vbox & make Style delta(D) option order same as
order(o) { although this is just for visual consistency since any delta
produces a report with some `-d1` mode }. Also combine first 4 eth devs.
Modernize darkBG & lightBG theme examples.
For >=100% just show integer percentage; 3 significant figures is plenty.
Ensure data is flushed to stdout before sleeping in differential mode.
Do not total syscall IO & blockdev IO for %<,%> (too often doubles IO).
Make build clean under `--styleCheck:hint --styleCheck:usages`. Also get
rid of cstring warnings. Fix several deprecations; mv `Table.add` ->
`Table.[]=` ; While technically [ug]id -> user name mapping is multivalued
we were only using a random one of the many values. Now the last writer
wins. Maybe 1st writer should, but user/group name aliases are rare.
Adapt to https://github.com/nim-lang/Nim/pull/17402
Use textAttrOff, not literal.
Make wchan 2 more terminal columns + __x86_sys_ prefix strip really enhances
readability of truncated System.map symbols.
Include RSS as well as rest of /proc/PID/(status|statm) in `minusEq` for
differential mode with `basic` style.
Work around a weird memory overallocation bug.
Get EUID working correctly (basically fstat on /proc/PID/ directory is reliable while entries under /proc/PID/ are not).
Now compiles and seems to work with --gc:arc (I could not break it, anyway).
On my machine, compiled with gcc-10-PGO and --gc:arc, Nim pd -d 0.00001
is now 775 samples per second compared to the C top -ib -d0 725/s. I.e.
Nim is 1.07x faster than C tuned for decades by performance sensitive top
watchers. It is true that top -b -d0 lseek()s & re-parses a few system-
wide files every sample (/proc/loadavg, /proc/stat, /proc/uptime), this is
in addition to literally 320 /proc/PID files and so unlikely to fully explain
the difference. I suspect the way top is reading /var/run/utmp very, very
carefully with several times over reset alarm(2) calls. Regardless, it's
probably fair to say performance parity with C is basically achieved now.
gc:arc remains rough, though. Besides
nim-lang/Nim#13269 and
nim-lang/Nim#13322, I also had to make these
commits to workaround what I think are independent other gc:arc bugs:
https://github.com/c-blake/procs/commit/7a0318f62143ef9334fd676cf6523b46587a2ebf
https://github.com/c-blake/procs/commit/dfcbf74939a3210c6a42a8b79a2f68df7b59a735
I tried to reduce those latter two bugs to small reproducibles but it was not
easy enough. So, I just worked around them instead.
Add parsers for /proc/loadavg, /proc/stat, /proc/diskstats, /proc/net/dev and
a new command-line subcommand scrollsy. This is still a work very much in
progress (needs at least parameterization for which disk/net iface/CPU).
Initial public release