New option -device_links

libisoburn/trunk/xorriso/xorriso.texi

@@ -50,7 +50,7 @@
 @c man .\" First parameter, NAME, should be all caps
 @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 @c man .\" other parameters are allowed: see man(7), man(1)
-@c man .TH XORRISO 1 "Version 1.1.3, Jul 24, 2011"
+@c man .TH XORRISO 1 "Version 1.1.3, Jul 27, 2011"
 @c man .\" Please adjust this date whenever revising the manpage.
 @c man .\"
 @c man .\" Some roff macros, for reference:
@@ -431,7 +431,7 @@ On OpenSolaris:
 @*
 Get a list of accessible drives by command
 @*
-  -devices
+  -device_links
 @*
 It might be necessary to do this as
 @strong{superuser}
@@ -3612,6 +3612,19 @@ who is able to see all drives.
 @*
 Drives which are occupied by other processes get not shown.
 @c man .TP
+@item -device_links
+@kindex -device_links   gets list of drives
+@cindex Drive, get drive list, -device_links
+Like -devices, but presenting the drives with addresses of symbolic links
+which point to the actual device files.
+@*
+Modern GNU/Linux systems may shuffle drive addresses from boot to boot.
+The udev daemon is supposed to create links which always point to the
+same drive, regardless of its system address.
+The command -device_links shows the addresses of such links if they begin
+by "/dev/dvd" or "/dev/cd".
+Precedence is: "cdrw", "dvdrw", "cdrom", "dvd", "cd".
+@c man .TP
 @item -toc
 @*
 @kindex -toc   shows list of sessions
@@ -4898,13 +4911,13 @@ On Solaris use pfexec. Consider to restrict privileges of @command{xorriso} to
 "base,sys_devices" and to give r-permission to user or group.
 @*
 @sp 1
-$ xorriso -devices
+$ xorriso -device_links
 @*
-0  -dev '/dev/sr0' rwrw@minus{}@minus{} :  '_NEC    ' 'DVD_RW ND-4570A'
+1  -dev '/dev/cdrom1' rwrw@minus{}@minus{} :  'TSSTcorp' 'DVD-ROM SH-D162C
 @*
-1  -dev '/dev/sr1' rwrw@minus{}@minus{} :  'HL-DT-ST' 'DVDRAM GSA-4082B' 
+1  -dev '/dev/cdrw'   rwrw@minus{}@minus{} :  'TSSTcorp' 'CDDVDW SH-S223B'
 @*
-2  -dev '/dev/sr2' rwrw@minus{}@minus{} :  'PHILIPS ' 'SPD3300L' 
+2  -dev '/dev/cdrw3'  rwrw@minus{}@minus{} :  'HL-DT-ST' 'BDDVDRW_GGC-H20L'
 @c man .SS
 @c man .B Blank media and compose a new ISO image as batch run
 @node ExCreate, ExDialog, ExDevices, Examples