From 57693fdbfa136fd40924ed562ce8f94e5ba1a118 Mon Sep 17 00:00:00 2001
From: Alasdair Kergon <agk@redhat.com>
Date: Fri, 27 Feb 2004 19:36:49 +0000
Subject: [PATCH] Update man page incl. 'targets', event_nr.

---
 man/dmsetup.8 | 42 +++++++++++++++++++++++++++---------------
 1 file changed, 27 insertions(+), 15 deletions(-)

diff --git a/man/dmsetup.8 b/man/dmsetup.8
index 8f19e97..f33f59e 100644
--- a/man/dmsetup.8
+++ b/man/dmsetup.8
@@ -9,11 +9,7 @@ dmsetup \- low level logical volume management
 .B dmsetup remove
 .I device_name
 .br
-.B dmsetup load
-.I device_name [table_file]
-.br
-.B dmsetup clear
-.I device_name
+.B dmsetup remove_all
 .br
 .B dmsetup suspend
 .I device_name
@@ -21,6 +17,12 @@ dmsetup \- low level logical volume management
 .B dmsetup resume
 .I device_name
 .br
+.B dmsetup load
+.I device_name [table_file]
+.br
+.B dmsetup clear
+.I device_name
+.br
 .B dmsetup reload
 .I device_name [table_file]
 .br
@@ -35,9 +37,6 @@ dmsetup \- low level logical volume management
 .B dmsetup deps
 .I [device_name]
 .br
-.B dmsetup mknodes
-.I [device_name]
-.br
 .B dmsetup status
 .I [device_name]
 .br
@@ -46,8 +45,12 @@ dmsetup \- low level logical volume management
 .br
 .B dmsetup wait
 .I device_name
+.I [event_nr]
 .br
-.B dmsetup remove_all
+.B dmsetup mknodes
+.I [device_name]
+.br
+.B dmsetup targets
 .br
 .B dmsetup version
 .ad b
@@ -87,12 +90,12 @@ If successful a device will appear as
 /dev/device-mapper/<device-name>.  
 See below for information on the table format.
 .IP \fBdeps
-.I device_name
+.I [device_name]
 .br
 Outputs a list of (major, minor) pairs for devices referenced by the
 live table for the specified device.
 .IP \fBinfo
-.I device_name
+.I [device_name]
 .br
 Outputs some brief information about the device in the form:
 .br
@@ -137,7 +140,7 @@ Un-suspends a device.
 If an inactive table has been loaded, it becomes live.
 Postponed I/O then gets re-queued for processing.
 .IP \fBstatus
-.I device_name
+.I [device_name]
 .br
 Outputs status information for each of the device's targets.
 .IP \fBsuspend
@@ -147,18 +150,24 @@ Suspends a device.  Any I/O that has already been mapped by the device
 but has not yet completed will be flushed.  Any further I/O to that
 device will be postponed for as long as the device is suspended.
 .IP \fBtable
-.I device_name
+.I [device_name]
 .br
 Outputs the current table for the device in a format that can be fed
 back in using the create or load commands.
+.IP \fBtargets
+.br
+Displays the names and versions of the currently-loaded targets.
 .IP \fBversion
-.I device_name
 .br
 Outputs version information.
 .IP \fBwait
 .I device_name
+.I [event_nr]
 .br
-Sleeps until an event is triggered against a device.
+Sleeps until the event counter for device_name exceeds event_nr.
+Use -v to see the event number returned.
+To wait until the next event is triggered, use \fBinfo\fP to find
+the last event number.  
 .SH TABLE FORMAT
 Each line of the table specifies a single target and is of the form:
 .br
@@ -219,3 +228,6 @@ for creating devices with holes in them.
 
 .SH AUTHORS
 Original version: Joe Thornber (thornber@sistina.com)
+
+.SH SEE ALSO
+Device-mapper resource page: http://sources.redhat.com/dm/
-- 
2.43.5