This self-review case which I'm submitting on behalf of Cathy Zhou is
closed approved automatic due to its trivial nature, but as with other
such cases, it will be upgraded to a fast-track if need be.
Updated dladm(1M) and flowadm(1M) man pages are in the materials
directory.
Overview
========
This case is to correct several inconsistencies of the show-usage
subcommand between the current implementation and the man page which
was proposed in PSARC/2006/357, for both dladm(1M) and flowadm(1M)
commands. Further, an additional '-a' option will be added.
Details
=======
- Manpage inconsistencies
1. Remove the '-t' option
The usage records are always in chronological order, so '-t' is not
necessary.
2. Remove the '-p' option
The usage information will be printed out to stdout. Further, since
the '-F' option will be used to specify the output format, '-p' is
redundant and therefore is removed.
3. Use the '-F' option to specify the output format
Specifying the format of the network usage data output. The only
argument it currently takes is "gnuplot", which means the format
will be suitable for input to gnuplot.
4. Add the '-d' option
Display the dates of the records in the usage data.
- The new '-a' option
Today, the default behavior of the "dladm show-usage" and "flowadm
show-usage" subcommands is to show the historical usage information,
including the usage information for the flows and links that have
already been deleted. This could easily causes confusion since the
default behavior of all other dladm and flowadm subcommands is
showing information only for the existing set of links and flows on
the current system.
At the same time, historical information could be useful especially
for auditing purposes. Therefore, we propose to add an additional '-a'
option for both "dladm show-usage" and "flowadm show-usage" subcommands
and all historical usage information will still be showed if '-a' is
specified. The default behavior will be only to show the usage
information for the existing links and flows.
References
==========
[1] dladm(1M) manpage
[2] flowadm(1M) manpage
