New options -map and -map_single

xorriso/xorriso.1

@@ -2,7 +2,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 "May, 13, 2008"
+.TH XORRISO 1 "May, 15, 2008"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -166,10 +166,10 @@ capabilities.
 suitable for xorriso.
 .br
 Blank is the state of newly purchased optical media.
-With used CD-RW and DVD-RW it can be achieved by action -blank "fast".
+With used CD-RW and DVD-RW it can be achieved by action -blank "as_needed".
 Overwriteable media are considered blank unless they contain an ISO image
-suitable for xorriso. Action -blank "fast" can be used to invalidate the image
-on overwriteable media.
+suitable for xorriso. Action -blank "as_needed" can be used to invalidate the
+image on overwriteable media, or to apply eventual mandatory formatting.
 .br
 \fBAppendable\fR media accept further sessions. Either they are MMC
 multi-session media in appendable state, or they are overwriteable media
@@ -599,22 +599,12 @@ Like -add but read the parameter words from file disk_path
 or standard input if disk_path is "-". 
 The list must contain exactly one pathspec resp. disk_path pattern per line. 
 .TP
-\fB\-cpr\fR disk_path [***] iso_rr_path
-Insert the given files or directory trees from filesystem 
-into the ISO image.
-.br
-The rules for generating the ISO addresses are similar as with
-shell command cp -r. Nevertheless, directories of the iso_rr_path
-are created if necessary. Especially a not yet existing iso_rr_path
-will be handled as directory if multiple disk_paths are present.
-The leafnames of the multiple disk_paths will be grafted under that
-directory as would be done with an existing directory.
-.br
-If a single disk_path is present then a non-existing iso_rr_path will
-get the same type as the disk_path.
-.br
-If a disk_path does not begin with '/' then -cdx is prepended.
-If the iso_rr_path does not begin with '/' then -cd is prepended. 
+\fB\-map\fR disk_path iso_rr_path
+Insert file object disk_path into the ISO image as iso_rr_path. If disk_path
+is a directory then its whole sub tree is inserted into the ISO image.
+.TP
+\fB\-map_single\fR disk_path iso_rr_path
+Like -map, but if disk_path is a directory then its sub tree is not inserted.
 .TP
 \fB\-update\fR disk_path iso_rr_path
 Compare file object disk_path with file object iso_rr_path. If they do not
@@ -623,6 +613,10 @@ a matching copy of disk_path. This comparison will imply lengthy content
 reading before a decision is made. On the other hand it strives for the
 smallest possible amount of add-on data which is needed to achieve the
 matching copy.
+.br
+If disk_path is a directory and iso_rr_path does not exist yet, then the
+whole subtree will be inserted. Else only directory attributes will be
+updated.
 .TP
 \fB\-update_r\fR disk_path iso_rr_path
 Like -update but working recursively. I.e. all file objects below both
@@ -692,6 +686,23 @@ to the directory if it already contains all parts of the old disk file.
 If not all parts are present, then only those present parts will
 be updated.
 .TP
+\fB\-cpr\fR disk_path [***] iso_rr_path
+Insert the given files or directory trees from filesystem 
+into the ISO image.
+.br
+The rules for generating the ISO addresses are similar as with
+shell command cp -r. Nevertheless, directories of the iso_rr_path
+are created if necessary. Especially a not yet existing iso_rr_path
+will be handled as directory if multiple disk_paths are present.
+The leafnames of the multiple disk_paths will be grafted under that
+directory as would be done with an existing directory.
+.br
+If a single disk_path is present then a non-existing iso_rr_path will
+get the same type as the disk_path.
+.br
+If a disk_path does not begin with '/' then -cdx is prepended.
+If the iso_rr_path does not begin with '/' then -cd is prepended. 
+.TP
 \fB\-rm\fR iso_rr_path [***]
 Delete the given files from the ISO image.
 .br
@@ -1427,7 +1438,7 @@ who is able to see all drives.
 .br
 Drives which are occupied by other processes get not shown.
 .TP
-\fB\-print-size\fR
+\fB\-print_size\fR
 Print the foreseeable consumption of 2048 byte blocks
 by next -commit. This can last a while as a -commit gets
 prepared and only in last moment is revoked by this option.
@@ -1820,19 +1831,15 @@ Re-add some wanted stuff.
 Because no -dialog "on" is given, the program will then end by committing the
 session to media.
 .br
+\fB$\fR cd /home/me
+.br
 \fB$\fR xorriso -outdev /dev/sr2 \\
 .br
- -blank fast \\
+ -blank as_needed \\
 .br
- -pathspecs on \\
+ -map /home/me/sounds /sounds \\
 .br
- -add \\
-.br
-   /sounds=/home/me/sounds \\
-.br
-   /pictures \\
-.br
-   -- \\
+ -map /home/me/pictures /pictures \\
 .br
  -rm_r \\
 .br
@@ -1844,12 +1851,12 @@ session to media.
 .br
    -- \\
 .br
- -add \\
+ -cd / \\
 .br
-   /pictures/confidential/work*
+ -add pictures/confidential/work*
 .br
 Note that '/pictures/*private*' is a pattern for iso_rr_paths
-while /pictures/confidential/work* gets expanded by the shell
+while pictures/confidential/work* gets expanded by the shell
 with addresses from the hard disk.
 .SS
 .B A dialog session doing about the same
@@ -1864,7 +1871,7 @@ made ready for being overwritten and the loaded ISO image is made empty.
 In order to be able to eject the media, the session needs to be committed
 explicitely.
 .br
-.B $ xorriso -pathspecs on -dialog on -page 20 80
+.B $ xorriso -dialog on -page 20 80 -disk_pattern on
 .br
 enter option and arguments :
 .br
@@ -1872,11 +1879,11 @@ enter option and arguments :
 .br
 enter option and arguments :
 .br
-.B \-blank fast
+.B \-blank as_needed
 .br
 enter option and arguments :
 .br
-.B \-add /sounds=/home/me/sounds /pictures
+.B \-map /home/me/sounds /sounds -map /home/me/pictures /pictures
 .br
 enter option and arguments :
 .br
@@ -1884,7 +1891,11 @@ enter option and arguments :
 .br
 enter option and arguments :
 .br
-.B \-add /pictures/confidential/office /pictures/confidential/factory
+.B \-cdx /home/me/pictures -cd /pictures
+.br
+enter option and arguments :
+.br
+.B \-add confidential/office confidential/factory
 .br
 enter option and arguments :
 .br
@@ -1916,15 +1927,9 @@ Add new directory trees /sounds and /movies. Burn to the same media and eject.
 .br
  -chmod go-rwx /pictures/restricted -- \\
 .br
- -pathsspecs on \\
+ -map /home/me/prepared_for_dvd/sounds_dummy /sounds \\
 .br
- -add \\
-.br
-   /sounds=/home/me/prepared_for_dvd/sounds_dummy \\
-.br
-   /movies=/home/me/prepared_for_dvd/movies \\
-.br
-   -- \\
+ -map /home/me/prepared_for_dvd/movies /movies \\
 .br
  -commit -eject all
 .SS
@@ -1939,7 +1944,7 @@ first and only session to the output drive.
 .br
  ...
 .br
- -outdev /dev/sr0 -blank fast \\
+ -outdev /dev/sr0 -blank as_needed \\
 .br
  -commit -eject all
 .SS
@@ -2044,8 +2049,7 @@ With CD media, Linux mount accepts session numbers directly by its option
 \fBDo not write more than about 50 sessions\fR to one multi-session media.
 Theoretical limits are higher but in practice the media deteriorate more early.
 It might also be that your operating system has a session limit with mount.
-Always have a blank media ready to perform a full backup in case the update
-attempt fails. An overview of sessions is given by option -toc.
+An overview of sessions is given by option -toc.
 .br
 Sessions on multi-session media are separated by several MB of unused blocks.
 So with small sessions the payload capacity can become substantially lower
@@ -2057,14 +2061,17 @@ automatically.
 Have at least two media which you use alternatingly. So only older backups
 get endangered by the new write operation, while the newest backup is
 stored safely on a different media.
+Always have a blank media ready to perform a full backup in case the update
+attempt fails due to insufficient remaining capacity.
 .br 
 If you have enough re-useable media for a round-robin scheme then better do
 full backups with blank media each time. Blanking can be achieved by
 either a separate run:
 .br
-\fB$\fR xorriso -outdev /dev/sr0 -blank fast -eject all
+\fB$\fR xorriso -outdev /dev/sr0 -blank as_needed -eject all
 .br
-or in the update run by using option -blank "fast" before option -update_r.
+or in the update run by using option -blank "as_needed" before
+option -update_r.
 .br
 .SH FILES
 .SS