usage/synopsis should be consistent:
$ kstat -h
kstat: unknown option -- h
usage: kstat [-w wait] [name | provider:0:name:unit] ...
$ man -hs1 kstat
kstat [-w wait] [name | provider:instance:name:unit] ...
Stick with the manual text, which also has
instance An unsigned integer number. Currently, all statistics use an
instance number of 0
I'd consider this an implementation detail which might change someday.
Until then, don't train muscle-memory to hardcode zero or anything.
Feedback? OK?
Index: kstat.c
===================================================================
RCS file: /cvs/src/usr.bin/kstat/kstat.c,v
retrieving revision 1.10
diff -u -p -r1.10 kstat.c
--- kstat.c 5 May 2022 22:36:36 -0000 1.10
+++ kstat.c 5 Jul 2022 21:33:08 -0000
@@ -123,7 +123,7 @@ usage(void)
extern char *__progname;
fprintf(stderr, "usage: %s [-w wait] "
- "[name | provider:0:name:unit] ...\n", __progname);
+ "[name | provider:instance:name:unit] ...\n", __progname);
exit(1);
}
