inception review summary of PSARC/2009/364 - dlstat and flowstat

[Kais Belgaied]

Below are the main architectural issues from the PSARC/2009/364 
inception review,
to be addressed before the commitment review.

- Use of kstats as underlying stats, rather than a new way.
  The project team will need to justify why kstats aren't suitable for
  accumulating and reporting the counters needed to be extracted
  by dlstat and flowstat

- Drop the verb (show, show-history, reset) from the subcommand, replacing
  them with simple option. This is consistent with the rest of
  {vm,io,net,..}stat commands in the system.

- Multiple issues with reset stats:
  - The loss of information accumulated since boot time may hurt the
    diagnosability of problem with flows and links.
  - The action needs to be privileged.
  - suggestion: move the reset subcommand to {dl,flow}adm, with expected
    effect of resetting the state of the datalink/flow, which includes the
    usage statistics thereof.

- Clarify change of interface commitment level of existing show-* statistic
  related subcommands of dladm and flowadm, from 'committed' to
  'committed obsolete'

- The '-o' (+ or -) option, Be consistent with the rest of the commands in
  general, (ps, dladm etc.). Use -o with the exact list of columns to
  be displayed.

- Before commitment, the man pages need to be updated to reflect the changes
  from the inception review.

    Kais.