New option -device_links

libisoburn/trunk/xorriso/xorriso.1

@@ -9,7 +9,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH XORRISO 1 "Version 1.1.3, Jul 24, 2011"
+.TH XORRISO 1 "Version 1.1.3, Jul 27, 2011"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -305,7 +305,7 @@ On OpenSolaris:
 .br
 Get a list of accessible drives by command
 .br
-  \-devices
+  \-device_links
 .br
 It might be necessary to do this as
 \fBsuperuser\fR
@@ -3067,6 +3067,17 @@ who is able to see all drives.
 .br
 Drives which are occupied by other processes get not shown.
 .TP
+\fB\-device_links\fR
+Like \-devices, but presenting the drives with addresses of symbolic links
+which point to the actual device files.
+.br
+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".
+.TP
 \fB\-toc\fR
 .br
 Show media specific table of content. This is the media session history,
@@ -4130,13 +4141,13 @@ which shall be able to use the drives with \fBxorriso\fR.
 On Solaris use pfexec. Consider to restrict privileges of \fBxorriso\fR to
 "base,sys_devices" and to give r\-permission to user or group.
 .br
-$ xorriso \-devices
+$ xorriso \-device_links
 .br
-0  \-dev '/dev/sr0' rwrw\-\- :  '_NEC    ' 'DVD_RW ND\-4570A'
+1  \-dev '/dev/cdrom1' rwrw\-\- :  'TSSTcorp' 'DVD\-ROM SH\-D162C
 .br
-1  \-dev '/dev/sr1' rwrw\-\- :  'HL\-DT\-ST' 'DVDRAM GSA\-4082B' 
+1  \-dev '/dev/cdrw'   rwrw\-\- :  'TSSTcorp' 'CDDVDW SH\-S223B'
 .br
-2  \-dev '/dev/sr2' rwrw\-\- :  'PHILIPS ' 'SPD3300L' 
+2  \-dev '/dev/cdrw3'  rwrw\-\- :  'HL\-DT\-ST' 'BDDVDRW_GGC\-H20L'
 .SS
 .B Blank media and compose a new ISO image as batch run
 Aquire drive /dev/sr2, make media ready for writing a new image,