New command -data_cache_size

xorriso/xorriso.info

@@ -884,6 +884,21 @@ activate them only after image loading.
      non-empty write-only files are regarded as appendable rather than
      blank.
 
+-data_cache_size number_of_tiles blocks_per_tile
+     Set the size and granularity of the data cache which is used when
+     ISO images are loaded and when file content is read from ISO
+     images. The cache consists of several tiles, which each consists
+     of several blocks. A larger cache reduces the need for tiles being
+     read multiple times. Larger tiles might additionally improve the
+     data throughput from the drive, but can be wasteful if the data
+     are scattered over the medium.
+     Larger cache sizes help best with image loading from MMC drives.
+     They are an inferior alternative to -osirrox option "sort_lba_on".
+     blocks_per_tile must be a power of 2. E.g. 16, 32, or 64. The
+     overall cache size must not exceed 1 GiB.  The default values can
+     be restored by parameter "default" instead of one or both of the
+     numbers.  Currently the default is 32 tiles of 32 blocks = 2 MiB.
+
 
 File: xorriso.info,  Node: Insert,  Next: SetInsert,  Prev: Loading,  Up: Options
 
@@ -4388,6 +4403,7 @@ File: xorriso.info,  Node: CommandIdx,  Next: ConceptIdx,  Prev: Legal,  Up: Top
 * -cpr   inserts like with cp -r:        Insert.              (line 152)
 * -cpx   copies files to disk:           Restore.             (line  92)
 * -cut_out   inserts piece of data file: Insert.              (line 126)
+* -data_cache_size   adjusts read cache size: Loading.        (line 265)
 * -dev   acquires one drive for input and output: AqDrive.    (line  12)
 * -device_links   gets list of drives:   Inquiry.             (line  18)
 * -devices   gets list of drives:        Inquiry.             (line   7)
@@ -4641,6 +4657,7 @@ File: xorriso.info,  Node: ConceptIdx,  Prev: CommandIdx,  Up: Top
 * Growing, _definition:                  Methods.             (line  19)
 * Hard links, control handling, -hardlinks: Loading.          (line 110)
 * hidden, set in ISO image, -hide:       Manip.               (line 171)
+* Image reading, cache size, -data_cache_size: Loading.       (line 265)
 * Image, _definition:                    Model.               (line   9)
 * Image, demand volume id, -assert_volid: Loading.            (line  84)
 * Image, discard pending changes, -rollback: Writing.         (line   9)
@@ -4832,47 +4849,47 @@ Node: Options23730
 Node: ArgSort25404
 Node: AqDrive26894
 Node: Loading29938
-Node: Insert44222
-Node: SetInsert53937
-Node: Manip62513
-Node: CmdFind71249
-Node: Filter83358
-Node: Writing87913
-Node: SetWrite96877
-Node: Bootable112152
-Node: Jigdo125374
-Node: Charset129620
-Node: Exception132381
-Node: DialogCtl138500
-Node: Inquiry141097
-Node: Navigate145963
-Node: Verify154224
-Node: Restore162913
-Node: Emulation169822
-Node: Scripting179633
-Node: Frontend186793
-Node: Examples188093
-Node: ExDevices189270
-Node: ExCreate189929
-Node: ExDialog191214
-Node: ExGrowing192479
-Node: ExModifying193284
-Node: ExBootable193788
-Node: ExCharset194340
-Node: ExPseudo195161
-Node: ExCdrecord196059
-Node: ExMkisofs196376
-Node: ExGrowisofs197716
-Node: ExException198851
-Node: ExTime199305
-Node: ExIncBackup199764
-Node: ExRestore203755
-Node: ExRecovery204715
-Node: Files205285
-Node: Seealso206584
-Node: Bugreport207307
-Node: Legal207888
-Node: CommandIdx208818
-Node: ConceptIdx224333
+Node: Insert45147
+Node: SetInsert54862
+Node: Manip63438
+Node: CmdFind72174
+Node: Filter84283
+Node: Writing88838
+Node: SetWrite97802
+Node: Bootable113077
+Node: Jigdo126299
+Node: Charset130545
+Node: Exception133306
+Node: DialogCtl139425
+Node: Inquiry142022
+Node: Navigate146888
+Node: Verify155149
+Node: Restore163838
+Node: Emulation170747
+Node: Scripting180558
+Node: Frontend187718
+Node: Examples189018
+Node: ExDevices190195
+Node: ExCreate190854
+Node: ExDialog192139
+Node: ExGrowing193404
+Node: ExModifying194209
+Node: ExBootable194713
+Node: ExCharset195265
+Node: ExPseudo196086
+Node: ExCdrecord196984
+Node: ExMkisofs197301
+Node: ExGrowisofs198641
+Node: ExException199776
+Node: ExTime200230
+Node: ExIncBackup200689
+Node: ExRestore204680
+Node: ExRecovery205640
+Node: Files206210
+Node: Seealso207509
+Node: Bugreport208232
+Node: Legal208813
+Node: CommandIdx209743
+Node: ConceptIdx225331
 
 End Tag Table