shaba/lvm2
1
0
Fork 0
mirror of git://sourceware.org/git/lvm2.git synced 2024-12-22 17:35:59 +03:00
Code Releases Activity
931fede81b
lvm2/man/dmstats.8.in

890 lines
23 KiB
Groff
Raw Normal View History

man: fix typo in dmstats.8.in
2015-09-03 01:01:46 +03:00
.TH DMSTATS 8 "Jul 25 2015" "Linux" "MAINTENANCE COMMANDS"
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.de OPT_PROGRAMS
. RB \%[ \-\-allprograms | \-\-programid
. IR id ]
..
.
.de OPT_REGIONS
. RB \%[ \-\-allregions | \-\-regionid
. IR id ]
..
.
.\" Print units suffix, use with arg to print human
.\" man2html can't handle too many changes per command
.de UNITS
. BR b | B | s | S | k | K | m | M | \c
. BR g | G | t | T | p | P | e | E ]
..
.
.\" Print help text for units, use with arg to print human
.de HELP_UNITS
. RB ( b )ytes,
. RB ( s )ectors,
. RB ( k )ilobytes,
. RB ( m )egabytes,
. RB ( g )igabytes,
. RB ( t )erabytes,
. RB ( p )etabytes,
. RB ( e )xabytes.
. nop Capitalise to use multiples of 1000 (S.I.) instead of 1024.
..
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SH NAME
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
dmstats \(em device-mapper statistics management
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SH SYNOPSIS
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.B dmsetup
.B stats
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.I command
.RB [ options ]
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.sp
.
man: enhance dmsetup/dmstats Document more supported options. Cleanup man-style when documenting options. Use .PD 0 and .HP
2015-09-18 15:34:34 +03:00
.PD 0
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.HP
man: enhance dmsetup/dmstats Document more supported options. Cleanup man-style when documenting options. Use .PD 0 and .HP
2015-09-18 15:34:34 +03:00
.B dmstats
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.de CMD_COMMAND
. ad l
. IR command
. RI [ device_name
. RB | \-\-uuid
. IR uuid | \fB\-\-major
. IR major
. BR \-\-minor
. IR minor ]
. ad b
..
.CMD_COMMAND
.
man: enhance dmsetup/dmstats Document more supported options. Cleanup man-style when documenting options. Use .PD 0 and .HP
2015-09-18 15:34:34 +03:00
.HP
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.B dmstats
.de CMD_CLEAR
. ad l
. BR clear
. IR device_name
. OPT_PROGRAMS
. OPT_REGIONS
. ad b
..
.CMD_CLEAR
.
.HP
.B dmstats
.de CMD_CREATE
. ad l
. BR create
. IR device_name
. RB [ \-\-alldevices ]
. RB [ \-\-areas
. IR nr_areas | \fB\-\-areasize
. IR area_size ]
. RB [ \-\-bounds
. IR \%histogram_boundaries ]
. RB [ \-\-precise ]
. RB [ \-\-start
. IR start_sector
. BR \-\-length
. IR length | \fB\-\-segments ]
. RB \%[ \-\-auxdata
. IR data ]
. RB [ \-\-programid
. IR id ]
. ad b
..
.CMD_CREATE
.
.HP
.B dmstats
.de CMD_DELETE
. ad l
. BR delete
. RI [ device_name ]
. RB [ \-\-alldevices ]
. OPT_PROGRAMS
. OPT_REGIONS
. ad b
..
.CMD_DELETE
.
man: enhance dmsetup/dmstats Document more supported options. Cleanup man-style when documenting options. Use .PD 0 and .HP
2015-09-18 15:34:34 +03:00
.HP
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.B dmstats
.de CMD_HELP
. ad l
. BR help
. RB [ \-c | \-C | \-\-columns ]
. ad b
..
.CMD_HELP
.
.HP
.B dmstats
.de CMD_LIST
. ad l
. BR list
. RI [ device_name ]
. RB [ \-\-histogram ]
. OPT_PROGRAMS
. RB [ \-\-units
. IR units ]
. RB \%[ \-\-nosuffix ]
. RB [ \-\-notimesuffix ]
. RB \%[ \-v | \-\-verbose [ \-v | \-\-verbose ]]
. ad b
..
.CMD_LIST
.
.HP
.B dmstats
.de CMD_PRINT
. ad l
. BR print
. RI [ device_name ]
. RB [ \-\-clear ]
. OPT_PROGRAMS
. OPT_REGIONS
. ad b
..
.CMD_PRINT
.
.HP
.B dmstats
.de CMD_REPORT
. ad l
. BR report
. RI [ device_name ]
. RB [ \-\-interval
. IR seconds ]
. RB [ \-\-count
. IR count ]
. RB [ \-\-units
. IR units ]
. RB [ \-\-histogram ]
. OPT_PROGRAMS
. OPT_REGIONS
. RB [ \-O | \-\-sort
. IR sort_fields ]
. RB [ \-S | \-\-select
. IR selection ]
. RB [ \-\-units
. IR units ]
. RB [ \-\-nosuffix ]
. RB \%[ \-\-notimesuffix ]
. ad b
..
.CMD_REPORT
.
.PD
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.ad b
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SH DESCRIPTION
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
The dmstats program manages IO statistics regions for devices that use
the device-mapper driver. Statistics regions may be created, deleted,
listed and reported on using the tool.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
The first argument to dmstats is a \fIcommand\fP.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
The second argument is the \fIdevice name\fP,
\fIuuid\fP or \fImajor\fP and \fIminor\fP numbers.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Further options permit the selection of regions, output format
control, and reporting behaviour.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
When the program is run using the '\fBdmstats\fP' alias, the command
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
\fBmust\fP be the first argument and any switches and options should be
specified following the command itself. This limitation is not present
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
when run as '\fBdmsetup stats\fP'.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
When no device argument is given dmstats will by default operate on all
device-mapper devices present. The \fBcreate\fP and \fBdelete\fP
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
commands require the use of \fB\-\-alldevices\fP when used in this way.
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SH OPTIONS
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-alldevices
.br
dmstats: replace --force with new stats-specific --alldevices The '--force' switch is only used by dmstats to allow either creation or deletion of one or more regions on all devices. These operations do not carry any risk: just a possible mess of region IDs to be cleaned up. Remove the use of '--force' for stats commands and change current uses to a new '--alldevices' switch.
2015-08-13 16:42:55 +03:00
If no device arguments are given allow operation on all devices when
creating or deleting regions.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-allprograms
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Include regions from all program IDs for list and report operations.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.br
.HP
.BR \-\-allregions
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Include all present regions for commands that normally accept a single
region identifier.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-areas
.IR nr_areas
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify the number of statistics areas to create within a new region.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-areasize
.IR area_size \c
.RB [ \c
.UNITS
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify the size of areas into which a new region should be divided. An
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
optional suffix selects units of:
.HELP_UNITS
.
.HP
.BR \-\-auxdata
.IR aux_data
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify auxilliary data (a string) to be stored with a new region.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-clear
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
When printing statistics counters, also atomically reset them to zero.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-count
.IR count
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify the iteration count for repeating reports. If the count
argument is zero reports will continue to repeat until interrupted.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-bounds
.IR histogram_boundaries \c
.RB [ ns | us | ms | s ]
.br
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
Specify the boundaries of a latency histogram to be tracked for the
region as a comma separated list of latency values. Latency values are
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
given in nanoseconds. An optional unit suffix of
.BR ns ,
.BR us ,
.BR ms ,
or \fBs\fP may be given after each value to specify units of
nanoseconds, microseconds, miliseconds or seconds respectively.
.
.HP
.BR \-\-histogram
.br
dmstats: replace histogram command with switch Replace the histogram stats subcommand with a --histogram switch to enable histogram related fields for both list and report output. To avoid overloading the existing --histogram rename it to --bounds: this is also a better description of the option.
2015-09-04 01:00:44 +03:00
When used with the \fBreport\fP and \fBlist\fP commands select default
fields that emphasize latency histogram data.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-interval
.IR seconds
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify the interval in seconds between successive iterations for
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
repeating reports. If \fB\-\-interval\fP is specified but
\fB\-\-count\fP is not,
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
reports will continue to repeat until interrupted.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-length
.IR length \c
.RB [ \c
.UNITS
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify the length of a new statistics region in sectors. An optional
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
suffix selects units of:
.HELP_UNITS
.
.HP
.BR \-j | \-\-major
.IR major
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify the major number.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-m | \-\-minor
.IR minor
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify the minor number.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-nosuffix
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Suppress the suffix on output sizes. Use with \fB\-\-units\fP
(except h and H) if processing the output.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-notimesuffix
.br
dmstats: add --notimesuffix switch Add a switch to disable the printing of time unit suffixes in histogram bounds descriptions.
2015-09-03 23:55:25 +03:00
Suppress the suffix on output time values. Histogram boundary values
will be reported in units of nanoseconds.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.BR \-o | \-\-options
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify which report fields to display.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-O | \-\-sort
.IR sort_fields
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Sort output according to the list of fields given. Precede any
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
sort field with '\fB-\fP' for a reverse sort on that column.
.
.HP
dmstats: add --precise switch to enable nanosecond counters.
2015-08-18 14:39:34 +03:00
.BR \-\-precise
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.br
dmstats: add --precise switch to enable nanosecond counters.
2015-08-18 14:39:34 +03:00
Attempt to use nanosecond precision counters when creating new
statistics regions.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-programid
.IR id
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify a program ID string. When creating new statistics regions this
string is stored with the region. Subsequent operations may supply a
program ID in order to select only regions with a matching value. The
default program ID for dmstats-managed regions is "dmstats".
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-regionid
.IR id
.br
man: document --regionid in dmstats.8.in
2015-09-02 22:35:43 +03:00
Specify the region to operate on.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
.BR \-\-relative
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.br
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
If displaying the histogram report show relative (percentage) values
instead of absolute counts.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-S | \-\-select
.IR selection
.br
Display only rows that match \fIselection\fP criteria. All rows with the
additional "selected" column (\fB\-o selected\fP) showing 1 if the row matches
the \fIselection\fP and 0 otherwise. The selection criteria are defined by
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
specifying column names and their valid values while making use of
supported comparison operators.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-start
.IR start \c
.RB [ \c
.UNITS
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify the start offset of a new statistics region in sectors. An
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
optional suffix selects units of:
.HELP_UNITS
.
.HP
.BR \-\-segments
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Create a new statistics region for each target contained in the target
device. This causes a separate region to be allocated for each segment
of the device.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-\-units
.RI [ units ] \c
.RB [ h | H | \c
.UNITS
.br
Set the display units for report output.
All sizes are output in these units:
.RB ( h )uman-readable,
.HELP_UNITS
Can also specify custom units e.g. \fB\-\-units\ 3M\fP.
.
.HP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.BR \-u | \-\-uuid
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.br
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Specify the uuid.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.BR \-v | \-\-verbose " [" \-v | \-\-verbose ]
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
Produce additional output.
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SH COMMANDS
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.CMD_CLEAR
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
Instructs the kernel to clear statistics counters for the speficied
regions (with the exception of in-flight IO counters).
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.CMD_CREATE
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
Creates one or more new statistics regions on the specified device(s).
The region will span the entire device unless \fB\-\-start\fP and
\fB\-\-length\fP or \fB\-\-target\fP are given. The \fB\-\-start\fP and
\fB\-\-length\fP options allow a region of arbitrary length to be placed
at an arbitrary offset into the device. The \fB\-\-segments\fP option
causes a new region to be created for each target in the corresponding
device-mapper device's table.
dmstats: add --precise switch to enable nanosecond counters.
2015-08-18 14:39:34 +03:00
If the \fB\-\-precise\fP option is used the command will attempt to
create a region using nanosecond precision counters.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
If \fB\-\-bounds\fP is given a latency histogram will be tracked for
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
the new region. The boundaries of the histogram bins are given as a
comma separated list of latency values. There is an implicit lower bound
of zero on the first bin and an implicit upper bound of infinity (or the
configured interval duration) on the final bin.
Latencies are given in nanoseconds. An optional unit suffix of ns, us,
ms, or s may be given after each value to specify units of nanoseconds,
microseconds, miliseconds or seconds respectively, so for example, 10ms
is equivalent to 10000000. Latency values with a precision of less than
one milisecond can only be used when precise timestamps are enabled: if
\fB\-\-precise\fP is not given and values less than one milisecond are
used it will be enabled automatically.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
An optional \fBprogram_id\fP or \fBaux_data\fP string may be associated
with the region. A \fBprogram_id\fP may then be used to select regions
for subsequent list, print, and report operations. The \fBaux_data\fP
stores an arbitrary string and is not used by dmstats or the
device-mapper kernel statistics subsystem.
By default dmstats creates regions with a \fBprogram_id\fP of
man: fix program_id string in dmstats.8.in
2015-08-20 14:18:51 +03:00
"dmstats".
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
On success the \fBregion_id\fP of the newly created region is printed to
stdout.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.CMD_DELETE
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
Delete the specified statistics region. All counters and resources used
by the region are released and the region will not appear in the output
of subsequent list, print, or report operations.
All regions registered on a device may be removed using
\fB\-\-allregions\fP.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
To remove all regions on all devices both \fB\-\-allregions\fP and
dmstats: replace --force with new stats-specific --alldevices The '--force' switch is only used by dmstats to allow either creation or deletion of one or more regions on all devices. These operations do not carry any risk: just a possible mess of region IDs to be cleaned up. Remove the use of '--force' for stats commands and change current uses to a new '--alldevices' switch.
2015-08-13 16:42:55 +03:00
\fB\-\-alldevices\fP must be used.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.CMD_HELP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
Outputs a summary of the commands available, optionally including
the list of report fields.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.CMD_LIST
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
List the statistics regions registered on the device. If the
\fB\-\-allprograms\fP switch is given all regions will be listed
regardless of region program ID values.
dmstats: make -v enable per area reports for 'stats list' When dmstats is run with -v or higher enable a per-area reporting mode for statistics regions. This will output one row per area (rather than one row per region) and adds additional fields of use when viewing areas: area_id - index within the region assigned by libdm-stats area_start - the start location of the area in the containing device.
2015-08-14 22:40:13 +03:00
If \fB\-v\fP or \fB\-\-verbose\fP is given the report will include
a row of information for each area contained in each region displayed.
dmstats: replace histogram command with switch Replace the histogram stats subcommand with a --histogram switch to enable histogram related fields for both list and report output. To avoid overloading the existing --histogram rename it to --bounds: this is also a better description of the option.
2015-09-04 01:00:44 +03:00
If \fB\-\-histogram\fP is given the report will include the bin count
and latency boundary values for any configured histograms.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.CMD_PRINT
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
Print raw statistics counters for the specified region or for all
present regions.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
.HP
.CMD_REPORT
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
Start a report for the specified region or for all present regions. If
the count argument is specified, the report will repeat at a fixed
interval set by the \fB\-\-interval\fP option. The default interval is
one second.
If the \fB\-\-allprograms\fP switch is given, all regions will be
listed, regardless of region program ID values.
dmstats: replace histogram command with switch Replace the histogram stats subcommand with a --histogram switch to enable histogram related fields for both list and report output. To avoid overloading the existing --histogram rename it to --bounds: this is also a better description of the option.
2015-09-04 01:00:44 +03:00
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
If the \fB\-\-histogram\fP is given the report will include the histogram
dmstats: replace histogram command with switch Replace the histogram stats subcommand with a --histogram switch to enable histogram related fields for both list and report output. To avoid overloading the existing --histogram rename it to --bounds: this is also a better description of the option.
2015-09-04 01:00:44 +03:00
values and latency boundaries.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
If the \fB\-\-relative\fP is used the default histogram field displays
dmstats: replace histogram command with switch Replace the histogram stats subcommand with a --histogram switch to enable histogram related fields for both list and report output. To avoid overloading the existing --histogram rename it to --bounds: this is also a better description of the option.
2015-09-04 01:00:44 +03:00
bin values as a percentage of the total number of I/Os.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SH REGIONS AND AREAS
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
The device-mapper statistics facility allows separate performance
counters to be maintained for arbitrary regions of devices. A region may
span any range: from a single sector to the whole device. A region may
be further sub-divided into a number of distinct areas (one or more),
each with its own counter set.
By default new regions span the entire device. The \fB\-\-start\fP and
\fB\-\-length\fP options allows a region of any size to be placed at any
location on the device.
A region may be either divided into the specified number of equal-sized
areas, or into areas of the given size by specifying one of
\fB\-\-areas\fP or \fB\-\-areasize\fP when creating a region with the
\fBcreate\fP command. Depending on the size of the areas and the device
region the final area within the region may be smaller than requested.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.P
.B Region identifiers
.P
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Each region is assigned an identifier when it is created that is used to
reference the region in subsequent operations. Region identifiers are
unique within a given device (including across different \fBprogram_id\fP
values).
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Depending on the sequence of create and delete operations, gaps may
exist in the sequence of \fBregion_id\fP values for a particular device.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SH REPORT FIELDS
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
The dmstats report provides several types of field that may be added to
the default field set, or used to create custom reports.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
All performance counters and metrics are calculated per-area.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SS Derived metrics
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
A number of metrics fields are included that provide high level
performance indicators. These are based on the fields provided by the
conventional Linux iostat program and are derived from the basic counter
values provided by the kernel for each area.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B reads_merged_per_sec
Reads merged per second.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B writes_merged_per_sec
Writes merged per second.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B reads_per_sec
Reads completed per second.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B writes_per_sec
Writes completed per second.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B read_size_per_sec
Size of data read per second.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B write_size_per_sec
Size of data written per second.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B avg_request_size
Average request size.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B queue_size
Average queue size.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B await
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
The average wait time for read and write operations.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B r_await
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
The average wait time for read operations.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B w_await
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
The average wait time for write operations.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B throughput
The device throughput in operations per second.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B service_time
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
The average service time (in milliseconds) for operations issued
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
to the device.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B util
Percentage of CPU time during which I/O requests were issued to the
device (bandwidth utilization for the device). Device saturation occurs
when this value is close to 100%.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SS Region and area meta fields
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Meta fields provide information about the region or area that the
statistics values relate to. This includes the region and area
identifier, start, length, and counts, as well as the program ID and
auxiliary data values.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B region_id
Region identifier. This is a non-negative integer returned by the kernel
when a statistics region is created.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B region_start
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
The region start location. Display units are selected by the
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
\fB\-\-units\fP option.
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B region_len
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
The length of the region. Display units are selected by the
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
\fB\-\-units\fP option.
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B area_id
Area identifier. Area identifiers are assigned by the device-mapper
statistics library and uniquely identify each area within a region. Each
ID corresponds to a distinct set of performance counters for that area
of the statistics region. Area identifiers are always monotonically
increasing within a region so that higher ID values correspond to
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
greater sector addresses within the area and no gaps in the sequence of
identifiers exist.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B area_start
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
The area start location. Display units are selected by the
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
\fB\-\-units\fP option.
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B area_len
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
The length of the area. Display units are selected by the
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
\fB\-\-units\fP option.
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B area_count
The number of areas in this region.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B program_id
The program ID value associated with this region.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B aux_data
The auxiliary data value associated with this region.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add 'interval' and 'interval_ns' report fields Add a pair of fields to expose the current per-interval duation estimate. The 'interval' field provides a real value in units of seconds and the 'interval_ns' field provides the same quantity expressed as a whole number of nanoseconds.
2015-08-13 19:29:15 +03:00
.B interval_ns
The estimated interval over which the current counter values have
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
accumulated. The value is reported as an interger expressed in units
dmstats: add 'interval' and 'interval_ns' report fields Add a pair of fields to expose the current per-interval duation estimate. The 'interval' field provides a real value in units of seconds and the 'interval_ns' field provides the same quantity expressed as a whole number of nanoseconds.
2015-08-13 19:29:15 +03:00
of nanoseconds.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add 'interval' and 'interval_ns' report fields Add a pair of fields to expose the current per-interval duation estimate. The 'interval' field provides a real value in units of seconds and the 'interval_ns' field provides the same quantity expressed as a whole number of nanoseconds.
2015-08-13 19:29:15 +03:00
.B interval
The estimated interval over which the current counter values have
accumulated. The value is reported as a real number in units of
seconds.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SS Basic counters
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Basic counters provide access to the raw counter data from the kernel,
allowing further processing to be carried out by another program.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.P
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
The kernel provides thirteen separate counters for each statistics
area. The first eleven of these match the counters provided in
/proc/diskstats or /sys/block/*/*/stat. The final pair provide separate
counters for read and write time.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B read_count
Count of reads completed this interval.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B reads_merged_count
Count of reads merged this interval.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B read_sector_count
Count of 512 byte sectors read this interval.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B read_time
Accumulated duration of all read requests (ns).
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B write_count
Count of writes completed this interval.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B writes_merged_count
Count of writes merged this interval.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B write_sector_count
Count of 512 byte sectors written this interval.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.B write_nsecs
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
Accumulated duration of all write requests (ns).
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B in_progress_count
Count of requests currently in progress.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B io_ticks
Nanoseconds spent servicing requests.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B queue_ticks
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
This field is incremented at each I/O start, I/O completion, I/O merge,
or read of these stats by the number of I/Os in progress multiplied by
the number of milliseconds spent doing I/O since the last update of this
field. This can provide an easy measure of both I/O completion time and
the backlog that may be accumulating.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B read_ticks
Nanoseconds spent servicing reads.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: improve stats column names Improve the names and labels of stats reports columns, ensure that the minimum field widths allow unambiguos labels to be shown and update the man page descriptions of these fields.
2015-08-22 21:35:43 +03:00
.B write_ticks
Nanoseconds spent servicing writes.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
.SS Histogram fields
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
Histograms measure the frequency distribution of user specified I/O
latency intervals. Histogram bin boundaries are specified when a region
is created.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.P
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
A brief representation of the histogram values and latency intervals can
be included in the report using these fields.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
.B hist_count
A list of the histogram counts for the current statistics area in order
of ascending latency value. Each value represents the number of I/Os
with latency times falling into that bin's time range during the sample
period.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
.B hist_count_bounds
A list of the histogram counts for the current statistics area in order
of ascending latency value including bin boundaries: each count is
prefixed by the lower bound of the corresponding histogram bin.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
.B hist_count_ranges
A list of the histogram counts for the current statistics area in order
of ascending latency value including bin boundaries: each count is
prefixed by both the lower and upper bounds of the corresponding
histogram bin.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
.B hist_percent
A list of the relative histogram values for the current statistics area
in order of ascending latency value, expressed as a percentage. Each
value represents the proportion of I/Os with latency times falling into
that bin's time range during the sample period.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
.B hist_percent_bounds
A list of the relative histogram values for the current statistics area
in order of ascending latency value, expressed as a percentage and
including bin boundaries. Each value represents the proportion of I/Os
with latency times falling into that bin's time range during the sample
period and is prefixed with the corresponding bin's lower bound.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
.B hist_percent_ranges
A list of the relative histogram values for the current statistics area
in order of ascending latency value, expressed as a percentage and
including bin boundaries. Each value represents the proportion of I/Os
with latency times falling into that bin's time range during the sample
period and is prefixed with the corresponding bin's lower and upper
bounds.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
.B hist_bounds
A list of the histogram boundary values for the current statistics area
in order of ascending latency value. The values are expressed in whole
units of seconds, miliseconds, microseconds or nanoseconds with a suffix
indicating the unit.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
.B hist_ranges
A list of the histogram bin ranges for the current statistics area in
order of ascending latency value. The values are expressed as
"LOWER-UPPER" in whole units of seconds, miliseconds, microseconds or
nanoseconds with a suffix indicating the unit.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.TP
dmstats: add histogram support Add support to dmstats to create and report histograms. Add a --histogram switch to 'create' that accepts a string description of bin boundaries and DR_STATS and DR_STATS_META fields to report bin configuration and absolute and relative histogram values: hist_bins hist_bounds hist_ranges hist_count hist_count_bounds hist_count_ranges hist_percent hist_percent_bounds hist_percent_ranges A new 'histogram' subcommand displays a report that emphasizes histogram data as either counters or percentage values.
2015-08-18 14:40:03 +03:00
.B hist_bins
The number of latency histogram bins configured for the area.
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SH EXAMPLES
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Create a whole-device region with one area on vg00/lvol1
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
#
.B dmstats create vg00/lvol1
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples
2015-08-16 21:30:16 +03:00
vg00/lvol1: Created new region with 1 area(s) as region ID 0
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.P
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Create a 32M region 1G into device d0
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
#
.B dmstats create \-\-start 1G \-\-length 32M d0
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples
2015-08-16 21:30:16 +03:00
d0: Created new region with 1 area(s) as region ID 0
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.P
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Create a whole-device region with 8 areas on every device
.br
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
#
.B dmstats create \-\-areas 8
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples Make sure that correct 'dmstats create' messages are shown for all examples and fix LV examples to use correct dmsetup output name format (vg/lv -> vg-lv).
2015-09-02 14:19:13 +03:00
vg00-lvol1: Created new region with 8 area(s) as region ID 0
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples Make sure that correct 'dmstats create' messages are shown for all examples and fix LV examples to use correct dmsetup output name format (vg/lv -> vg-lv).
2015-09-02 14:19:13 +03:00
vg00-lvol2: Created new region with 8 area(s) as region ID 0
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples Make sure that correct 'dmstats create' messages are shown for all examples and fix LV examples to use correct dmsetup output name format (vg/lv -> vg-lv).
2015-09-02 14:19:13 +03:00
vg00-lvol3: Created new region with 8 area(s) as region ID 0
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples Make sure that correct 'dmstats create' messages are shown for all examples and fix LV examples to use correct dmsetup output name format (vg/lv -> vg-lv).
2015-09-02 14:19:13 +03:00
vg01-lvol0: Created new region with 8 area(s) as region ID 2
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples Make sure that correct 'dmstats create' messages are shown for all examples and fix LV examples to use correct dmsetup output name format (vg/lv -> vg-lv).
2015-09-02 14:19:13 +03:00
vg01-lvol1: Created new region with 8 area(s) as region ID 0
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples Make sure that correct 'dmstats create' messages are shown for all examples and fix LV examples to use correct dmsetup output name format (vg/lv -> vg-lv).
2015-09-02 14:19:13 +03:00
vg00-lvol2: Created new region with 8 area(s) as region ID 1
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.P
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Delete all regions on all devices
.br
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
#
.B dmstats delete \-\-alldevices \-\-allregions
.P
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Create a whole-device region with areas 10GiB in size on vg00/lvol1
using dmsetup
.br
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
#
.B dmsetup stats create \-\-areasize 10G vg00/lvol1
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples Make sure that correct 'dmstats create' messages are shown for all examples and fix LV examples to use correct dmsetup output name format (vg/lv -> vg-lv).
2015-09-02 14:19:13 +03:00
vg00-lvol1: Created new region with 5 area(s) as region ID 1
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.P
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Create a 1GiB region with 16 areas at the start of vg00/lvol1
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
#
.B dmstats create \-\-start 0 \-\-len 1G \-\-areas=16 vg00/lvol1
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples Make sure that correct 'dmstats create' messages are shown for all examples and fix LV examples to use correct dmsetup output name format (vg/lv -> vg-lv).
2015-09-02 14:19:13 +03:00
vg00-lvol1: Created new region with 16 area(s) as region ID 0
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.P
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
List the statistics regions registered on vg00/lvol1
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
#
.B dmstats list vg00/lvol1
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples
2015-08-16 21:30:16 +03:00
Name RgID RStart RSize #Areas ASize ProgID
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples
2015-08-16 21:30:16 +03:00
vg00-lvol1 0 0 61.00g 1 61.00g dmstats
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples
2015-08-16 21:30:16 +03:00
vg00-lvol1 1 61.00g 19.20g 1 19.20g dmstats
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples
2015-08-16 21:30:16 +03:00
vg00-lvol1 2 80.20g 2.14g 1 2.14g dmstats
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.P
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Display five statistics reports for vg00/lvol1 at an interval of one second
.br
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
#
.B dmstats report \-\-interval 1 \-\-count 5 vg00/lvol1
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
#
.B dmstats report
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples
2015-08-16 21:30:16 +03:00
Name RgID ArID AStart ASize RRqM/s WRqM/s R/s W/s RSz/s WSz/s AvRqSz QSize Util% AWait RdAWa WrAWa
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples
2015-08-16 21:30:16 +03:00
vg_hex-lv_home 0 0 0 61.00g 0.00 0.00 0.00 218.00 0 1.04m 4.50k 2.97 81.70 13.62 0.00 13.62
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples
2015-08-16 21:30:16 +03:00
vg_hex-lv_home 1 0 61.00g 19.20g 0.00 0.00 0.00 5.00 0 548.00k 109.50k 0.14 11.00 27.40 0.00 27.40
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples
2015-08-16 21:30:16 +03:00
vg_hex-lv_home 2 0 80.20g 2.14g 0.00 0.00 0.00 14.00 0 1.15m 84.00k 0.39 18.70 27.71 0.00 27.71
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.P
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Create one region for reach target contained in device vg00/lvol1
.br
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
#
.B dmstats create \-\-segments vg00/lvol1
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples Make sure that correct 'dmstats create' messages are shown for all examples and fix LV examples to use correct dmsetup output name format (vg/lv -> vg-lv).
2015-09-02 14:19:13 +03:00
vg00-lvol1: Created new region with 1 area(s) as region ID 0
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples Make sure that correct 'dmstats create' messages are shown for all examples and fix LV examples to use correct dmsetup output name format (vg/lv -> vg-lv).
2015-09-02 14:19:13 +03:00
vg00-lvol1: Created new region with 1 area(s) as region ID 1
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
man: update dmstats.8.in examples Make sure that correct 'dmstats create' messages are shown for all examples and fix LV examples to use correct dmsetup output name format (vg/lv -> vg-lv).
2015-09-02 14:19:13 +03:00
vg00-lvol1: Created new region with 1 area(s) as region ID 2
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.P
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Print raw counters for region 4 on device d0
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
#
.B dmstats print \-\-regionid 4 d0
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
2097152+65536 0 0 0 0 29 0 264 701 0 41 701 0 41
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SH AUTHORS
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
Bryn M. Reeves <bmr@redhat.com>
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.SH SEE ALSO
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.
man: enhance dmsetup/dmstats Document more supported options. Cleanup man-style when documenting options. Use .PD 0 and .HP
2015-09-18 15:34:34 +03:00
.BR dmsetup (8)
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
LVM2 resource page: https://www.sourceware.org/lvm2/
dmstats: add libdm-stats library and 'dmsetup stats' command Add the libdm-stats module to libdm: this implements a simple interface for creating, managing and interrogating I/O statistics regions and areas on device-mapper devices. The library interface is documented in libdevmapper.h and provides a 'dm_stats' handle that is used to perform statistics operations and obtain data. Public methods are provided to create and destroy handles and to list, create, and destroy statistics regions as well as to obtain and parse counter data and calculate rate-based metrics. This commit also adds a 'dmsetup stats' (aka 'dmstats') command with 'clear', 'create', 'delete', 'list', 'print', and 'report' sub-commands. See the library documentation and the dmstats.8 manual page for detailed API and command descriptions.
2015-08-05 12:40:00 +03:00
.br
Device-mapper resource page: http://sources.redhat.com/dm/
.br
Device-mapper statistics kernel documentation
.br
man: update dmsetup and dmstats pages Try to provide properly rendered pages no just with plain 'man' but also for: man -Tps man -Thtml man2html
2015-09-23 12:25:00 +03:00
.I Documentation/device-mapper/statistics.txt
Copy Permalink