libburnia/libisoburn
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

New environment variable SOURCE_DATE_EPOCH

Browse Source
This commit is contained in:
Thomas Schmitt
2016-08-16 13:18:31 +00:00
parent bda4b37e97
commit 384ff0eee9
8 changed files with 412 additions and 218 deletions
Download Patch File Download Diff File Expand all files Collapse all files

245
xorriso/xorriso.info
View File

@ -33,6 +33,7 @@ images with Rock Ridge extensions.
* Commands:: Reference of commands
* Examples:: Examples
* Files:: Files
* Environ:: Environment
* Seealso:: See also
* Bugreport:: Reporting bugs
* Legal:: Author, Copyright, Credits
@ -2399,10 +2400,17 @@ according to the setting of command -acl.
"m" time when volume was last modified.
"x" time when the information in the volume expires.
"f" time since when the volume is effectively valid.
"uuid" sets a timestring that overrides "c" and "m" times
literally. It must consist of 16 decimal digits which form
YYYYMMDDhhmmsscc, with YYYY between 1970 and 2999. Time zone is
GMT. It is supposed to match this GRUB line:
"all_file_dates" sets mtime, atime, and ctime of all files and
directories to the given time. This action stays delayed until
actual ISO production begins. Up to then it can be revoked by
"all_file_dates" with empty timestring.
The timestamps of the El Torito boot catalog file get refreshed
when the ISO is produced. They can be influenced by "uuid".
"uuid" sets a timestring that overrides "c" and "m" times literally
and sets the time of the El Torito boot catalog. It must consist
of 16 decimal digits which form YYYYMMDDhhmmsscc, with YYYY between
1970 and 2999. Time zone is GMT. It is supposed to match this GRUB
line:
search --fs-uuid --set YYYY-MM-DD-hh-mm-ss-cc
E.g. 2010040711405800 is 7 Apr 2010 11:40:58 (+0 centiseconds).
Timestrings for the other types may be given as with command
@ -3486,6 +3494,10 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Comm
boot facilities.
Modes *cmd* and *as_mkisofs* work like with command
-report_el_torito. See above.
With mode *gpt_disk_guid* print the GPT disk GUID of the loaded ISO
in RFC 4122 text format to result channel. It is not considered an
error if no GPT is present. In this case nothing is printed to
result channel.
With mode *gpt_crc_of:*disk_path read up to 32 KiB from the disk
file with the path given after the colon. Compute the GPT
compliant CRC number and print it to the result channel. The
@ -4997,7 +5009,7 @@ other -indev drives. See the human readable part of
with mount option -o sbsector= or -s.

File: xorriso.info, Node: Files, Next: Seealso, Prev: Examples, Up: Top
File: xorriso.info, Node: Files, Next: Environ, Prev: Examples, Up: Top
11 Files
********
@ -5043,9 +5055,25 @@ The default setting of -check_media abort_file= is:
/var/opt/xorriso/do_abort_check_media

File: xorriso.info, Node: Seealso, Next: Bugreport, Prev: Files, Up: Top
File: xorriso.info, Node: Environ, Next: Seealso, Prev: Files, Up: Top
12 See also
12 Environ
**********
The following environment variables influence the program behavior:
HOME is used to find xorriso and mkisofs startup files.
SOURCE_DATE_EPOCH belongs to the specs of reproducible-builds.org. It
is supposed to be either undefined or to contain a decimal number which
tells the seconds since january 1st 1970. If it contains a number, then
it is used as time value to set the default of -volume date "uuid",
-volume_date "all_file_dates", and it sets -boot_image "any"
"gpt_disk_guid=" to "volume_date_uuid". Startup files and program
options can override the effect of SOURCE_DATE_EPOCH.

File: xorriso.info, Node: Seealso, Next: Bugreport, Prev: Environ, Up: Top
13 See also
***********
For the mkisofs emulation of 'xorriso'
@ -5070,7 +5098,7 @@ On FreeBSD some commands differ:

File: xorriso.info, Node: Bugreport, Next: Legal, Prev: Seealso, Up: Top
13 Reporting bugs
14 Reporting bugs
*****************
To report bugs, request help, or suggest enhancements for 'xorriso',
@ -5086,16 +5114,16 @@ messages of 'xorriso', and the undesirable outcome of your program run.

File: xorriso.info, Node: Legal, Next: CommandIdx, Prev: Bugreport, Up: Top
14 Author, Copyright, Credits
15 Author, Copyright, Credits
*****************************
14.1 Author
15.1 Author
===========
Thomas Schmitt <scdbackup@gmx.net>
for libburnia-project.org
14.2 Copyright
15.2 Copyright
==============
Copyright (c) 2007 - 2016 Thomas Schmitt
@ -5104,7 +5132,7 @@ modified in sync with the technical properties of 'xorriso'. If you
make use of the license to derive modified versions of 'xorriso' then
you are entitled to modify this text under that same license.
14.3 Credits
15.3 Credits
============
'xorriso' is in part based on work by Vreixo Formoso who provides
@ -5118,7 +5146,7 @@ years.

File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
15 Alphabetic Command List
16 Alphabetic Command List
**************************
[index]
@ -5126,7 +5154,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* # starts a comment line: Scripting. (line 156)
* -abort_on controls abort on error: Exception. (line 27)
* -abstract_file sets abstract file name: SetWrite. (line 234)
* -abstract_file sets abstract file name: SetWrite. (line 241)
* -acl controls handling of ACLs: Loading. (line 171)
* -add inserts one or more paths: Insert. (line 44)
* -add_plainly inserts one or more paths: Insert. (line 68)
@ -5135,13 +5163,13 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -append_partition adds arbitrary file after image end: Bootable.
(line 391)
* -application_id sets application id: SetWrite. (line 191)
* -application_use sets application use field: SetWrite. (line 256)
* -application_use sets application use field: SetWrite. (line 263)
* -as emulates mkisofs or cdrecord: Emulation. (line 13)
* -assert_volid rejects undesired images: Loading. (line 111)
* -auto_charset learns character set from image: Loading. (line 123)
* -backslash_codes enables backslash conversion: Scripting. (line 71)
* -ban_stdio_write demands real drive: Loading. (line 316)
* -biblio_file sets biblio file name: SetWrite. (line 240)
* -biblio_file sets biblio file name: SetWrite. (line 247)
* -blank erases media: Writing. (line 57)
* -boot_image controls bootability: Bootable. (line 65)
* -calm_drive reduces drive activity: Loading. (line 306)
@ -5160,7 +5188,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -chown sets ownership in ISO image: Manip. (line 43)
* -chown_r sets ownership in ISO image: Manip. (line 47)
* -clone copies ISO directory tree: Insert. (line 170)
* -close controls media closing: SetWrite. (line 391)
* -close controls media closing: SetWrite. (line 398)
* -close_damaged closes damaged track and session: Writing. (line 164)
* -close_filter_list bans filter registration: Filter. (line 50)
* -commit writes pending ISO image: Writing. (line 27)
@ -5170,7 +5198,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -compare_r reports ISO/disk differences: Navigate. (line 140)
* -compliance controls standard compliance: SetWrite. (line 56)
* -concat copies ISO file content: Restore. (line 118)
* -copyright_file sets copyright file name: SetWrite. (line 229)
* -copyright_file sets copyright file name: SetWrite. (line 236)
* -cpax copies files to disk: Restore. (line 100)
* -cpr inserts like with cp -r: Insert. (line 149)
* -cpx copies files to disk: Restore. (line 89)
@ -5189,11 +5217,11 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
(line 57)
* -drive_class controls drive accessability: Loading. (line 73)
* -du show directory size in ISO image: Navigate. (line 75)
* -dummy controls write simulation: SetWrite. (line 383)
* -dummy controls write simulation: SetWrite. (line 390)
* -dus show directory size in ISO image: Navigate. (line 78)
* -dusx show directory size on disk: Navigate. (line 85)
* -dux show directory size on disk: Navigate. (line 81)
* -dvd_obs set write block size: SetWrite. (line 320)
* -dvd_obs set write block size: SetWrite. (line 327)
* -early_stdio_test classifies stdio drives: Loading. (line 320)
* -ecma119_map names w/o Rock Ridge, Joliet: Loading. (line 214)
* -eject ejects drive tray: Writing. (line 50)
@ -5213,12 +5241,12 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -follow softlinks and mount points: SetInsert. (line 69)
* -format formats media: Writing. (line 87)
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 210)
* -fs sets size of fifo: SetWrite. (line 386)
* -fs sets size of fifo: SetWrite. (line 393)
* -getfacl shows ACL in ISO image: Navigate. (line 60)
* -getfacl_r shows ACL in ISO image: Navigate. (line 66)
* -getfattr shows xattr in ISO image: Navigate. (line 69)
* -getfattr_r shows xattr in ISO image: Navigate. (line 72)
* -gid sets global ownership: SetWrite. (line 277)
* -gid sets global ownership: SetWrite. (line 284)
* -grow_blindly overides next writeable address: AqDrive. (line 60)
* -hardlinks controls handling of hard links: Loading. (line 134)
* -help prints help text: Scripting. (line 19)
@ -5256,7 +5284,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -mark sets synchronizing message: Frontend. (line 23)
* -md5 controls handling of MD5 sums: Loading. (line 182)
* -mkdir creates ISO directory: Insert. (line 162)
* -modesty_on_drive keep drive buffer hungry: SetWrite. (line 326)
* -modesty_on_drive keep drive buffer hungry: SetWrite. (line 333)
* -mount issues mount command for ISO session: Restore. (line 146)
* -mount_cmd composes mount command line: Inquiry. (line 49)
* -mount_cmd controls mount command: Inquiry. (line 64)
@ -5272,16 +5300,16 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -options_from_file reads commands from file: Scripting. (line 12)
* -osirrox enables ISO-to-disk copying: Restore. (line 18)
* -outdev acquires a drive for output: AqDrive. (line 29)
* -out_charset sets output character set: SetWrite. (line 269)
* -out_charset sets output character set: SetWrite. (line 276)
* -overwrite enables overwriting in ISO: SetInsert. (line 131)
* -pacifier controls pacifier text form: Emulation. (line 166)
* -padding sets amount or mode of image padding: SetWrite. (line 414)
* -padding sets amount or mode of image padding: SetWrite. (line 421)
* -page set terminal geometry: DialogCtl. (line 18)
* -paste_in copies file into disk file: Restore. (line 114)
* -pathspecs sets meaning of = with -add: SetInsert. (line 115)
* -path_list inserts paths from disk file: Insert. (line 81)
* -pkt_output consolidates text output: Frontend. (line 7)
* -preparer_id sets preparer id: SetWrite. (line 245)
* -preparer_id sets preparer id: SetWrite. (line 252)
* -print prints result text line: Scripting. (line 102)
* -print_info prints message text line: Scripting. (line 104)
* -print_mark prints synchronizing text line: Scripting. (line 106)
@ -5333,36 +5361,36 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -signal_handling controls handling of system signals: Exception.
(line 66)
* -sleep waits for a given time span: Scripting. (line 113)
* -speed set write speed: SetWrite. (line 291)
* -speed set write speed: SetWrite. (line 298)
* -split_size enables large file splitting: SetInsert. (line 143)
* -status shows current settings: Scripting. (line 44)
* -status_history_max curbs -status history: Scripting. (line 52)
* -stdio_sync controls stdio buffer: SetWrite. (line 376)
* -stream_recording controls defect management: SetWrite. (line 309)
* -stdio_sync controls stdio buffer: SetWrite. (line 383)
* -stream_recording controls defect management: SetWrite. (line 316)
* -system_id sets system id: SetWrite. (line 199)
* -tell_media_space reports free space: Inquiry. (line 97)
* -temp_mem_limit curbs memory consumption: Scripting. (line 96)
* -toc shows list of sessions: Inquiry. (line 27)
* -toc_of shows list of sessions: Inquiry. (line 41)
* -uid sets global ownership: SetWrite. (line 274)
* -uid sets global ownership: SetWrite. (line 281)
* -update inserts path if different: Insert. (line 100)
* -update_l inserts paths if different: Insert. (line 120)
* -update_r inserts paths if different: Insert. (line 110)
* -use_immed_bit controls use of Immed bit: SetWrite. (line 364)
* -use_immed_bit controls use of Immed bit: SetWrite. (line 371)
* -use_readline enables readline for dialog: DialogCtl. (line 26)
* -version prints help text: Scripting. (line 22)
* -volid sets volume id: SetWrite. (line 162)
* -volset_id sets volume set id: SetWrite. (line 182)
* -volume_date sets volume timestamp: SetWrite. (line 205)
* -write_type chooses TAO or SAO/DAO: SetWrite. (line 407)
* -write_type chooses TAO or SAO/DAO: SetWrite. (line 414)
* -x enables automatic execution order of arguments: ArgSort. (line 16)
* -xattr controls handling of xattr (EA): Loading. (line 178)
* -zisofs controls zisofs production: SetWrite. (line 280)
* -zisofs controls zisofs production: SetWrite. (line 287)

File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
16 Alphabetic List of Concepts and Objects
17 Alphabetic List of Concepts and Objects
******************************************
[index]
@ -5387,14 +5415,14 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Backup, enable features, -for_backup: Loading. (line 210)
* Backup, scdbackup checksum tag, -scdbackup: Emulation. (line 179)
* Blank media, _definition: Media. (line 29)
* Blank, format, Immed bit, -use_immed_bit: SetWrite. (line 364)
* Blank, format, Immed bit, -use_immed_bit: SetWrite. (line 371)
* Blind growing, _definition: Methods. (line 41)
* Bootability, control, -boot_image: Bootable. (line 65)
* Bugs, reporting: Bugreport. (line 6)
* cdrecord, Emulation: Emulation. (line 120)
* Character Set, for input, -in_charset: Loading. (line 118)
* Character Set, for input/output, -charset: Charset. (line 54)
* Character Set, for output, -out_charset: SetWrite. (line 269)
* Character Set, for output, -out_charset: SetWrite. (line 276)
* Character set, learn from image, -auto_charset: Loading. (line 123)
* Character Set, of terminal, -local_charset: Charset. (line 57)
* Character Set, _definition: Charset. (line 6)
@ -5456,13 +5484,13 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Filter, show chain, -show_stream: Navigate. (line 148)
* Filter, show chains of tree, -show_stream_r: Navigate. (line 161)
* Filter, unregister, -unregister_filter: Filter. (line 47)
* Filter, zisofs parameters, -zisofs: SetWrite. (line 280)
* Filter, zisofs parameters, -zisofs: SetWrite. (line 287)
* Filter, _definition: Filter. (line 6)
* Frontend program, start at pipes, -launch_frontend: Frontend.
(line 141)
* GPT, control GUID, -boot_image gpt_disk_guid=: Bootable. (line 210)
* GPT, _definition: Extras. (line 39)
* Group, global in ISO image, -gid: SetWrite. (line 277)
* Group, global in ISO image, -gid: SetWrite. (line 284)
* Group, in ISO image, -chgrp: Manip. (line 49)
* Group, in ISO image, -chgrp_r: Manip. (line 53)
* Growing, _definition: Methods. (line 20)
@ -5476,13 +5504,13 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Image, discard pending changes, -rollback: Writing. (line 9)
* Image, filesystem to load, -read_fs: Loading. (line 102)
* Image, override change status, -changes_pending: Writing. (line 12)
* Image, set abstract file name, -abstract_file: SetWrite. (line 234)
* Image, set abstract file name, -abstract_file: SetWrite. (line 241)
* Image, set application id, -application_id: SetWrite. (line 191)
* Image, set application iuse field, -application_use: SetWrite.
(line 256)
* Image, set biblio file name, -biblio_file: SetWrite. (line 240)
* Image, set copyright file name, -copyright_file: SetWrite. (line 229)
* Image, set preparer id, -preparer_id: SetWrite. (line 245)
(line 263)
* Image, set biblio file name, -biblio_file: SetWrite. (line 247)
* Image, set copyright file name, -copyright_file: SetWrite. (line 236)
* Image, set preparer id, -preparer_id: SetWrite. (line 252)
* Image, set publisher id, -publisher: SetWrite. (line 186)
* Image, set system id, -system_id: SetWrite. (line 199)
* Image, set volume id, -volid: SetWrite. (line 162)
@ -5556,7 +5584,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Next writeable address, -grow_blindly: AqDrive. (line 60)
* Output Character Set, _definition: Charset. (line 26)
* Overwriteable media, _definition: Media. (line 14)
* Ownership, global in ISO image, -uid: SetWrite. (line 274)
* Ownership, global in ISO image, -uid: SetWrite. (line 281)
* Ownership, in ISO image, -chown: Manip. (line 43)
* Ownership, in ISO image, -chown_r: Manip. (line 47)
* Partition offset, _definition: Bootable. (line 286)
@ -5645,26 +5673,26 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Verify, file checksum, -check_md5: Verify. (line 164)
* Verify, file tree checksums, -check_md5_r: Verify. (line 178)
* Verify, preset -check_media, -check_media_defaults: Verify. (line 40)
* Write, block size, -dvd_obs: SetWrite. (line 320)
* Write, block size, -dvd_obs: SetWrite. (line 327)
* Write, bootability, -boot_image: Bootable. (line 65)
* Write, buffer syncing, -stdio_sync: SetWrite. (line 376)
* Write, close media, -close: SetWrite. (line 391)
* Write, buffer syncing, -stdio_sync: SetWrite. (line 383)
* Write, close media, -close: SetWrite. (line 398)
* Write, compliance to specs, -compliance: SetWrite. (line 56)
* Write, defect management, -stream_recording: SetWrite. (line 309)
* Write, defect management, -stream_recording: SetWrite. (line 316)
* Write, disable Rock Ridge, -rockridge: SetWrite. (line 51)
* Write, drive buffer, -modesty_on_drive: SetWrite. (line 326)
* Write, drive buffer, -modesty_on_drive: SetWrite. (line 333)
* Write, enable HFS+, -hfsplus: SetWrite. (line 14)
* Write, enable Joliet, -joliet: SetWrite. (line 10)
* Write, fifo size, -fs: SetWrite. (line 386)
* Write, fifo size, -fs: SetWrite. (line 393)
* Write, free space, -tell_media_space: Inquiry. (line 97)
* Write, log problematic disk files, -errfile_log: Scripting. (line 116)
* Write, log written sessions, -session_log: Scripting. (line 134)
* Write, padding image, -padding: SetWrite. (line 414)
* Write, padding image, -padding: SetWrite. (line 421)
* Write, pending ISO image, -commit: Writing. (line 27)
* Write, predict image size, -print_size: Inquiry. (line 85)
* Write, set speed, -speed: SetWrite. (line 291)
* Write, simulation, -dummy: SetWrite. (line 383)
* Write, TAO or SAO/DAO, -write_type: SetWrite. (line 407)
* Write, set speed, -speed: SetWrite. (line 298)
* Write, simulation, -dummy: SetWrite. (line 390)
* Write, TAO or SAO/DAO, -write_type: SetWrite. (line 414)
* xattr, control handling, -xattr: Loading. (line 178)
* xattr, set in ISO image, -setfattr: Manip. (line 103)
* xattr, set in ISO image, -setfattr_list: Manip. (line 117)
@ -5677,59 +5705,60 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top

Tag Table:
Node: Top415
Node: Overview1369
Node: Model3406
Node: Media6310
Node: Methods8997
Node: Drives11583
Node: Extras15525
Node: Processing19993
Node: Dialog23628
Node: Commands25317
Node: ArgSort26994
Node: AqDrive28488
Node: Loading32602
Node: Insert52709
Node: SetInsert63293
Node: Manip72612
Node: CmdFind82571
Node: Filter100874
Node: Writing105496
Node: SetWrite115652
Node: Bootable139799
Node: Jigdo164535
Node: Charset168794
Node: Exception172123
Node: DialogCtl178252
Node: Inquiry180854
Node: Navigate189406
Node: Verify197701
Node: Restore207579
Node: Emulation216192
Node: Scripting226651
Node: Frontend234434
Node: Examples244060
Node: ExDevices245238
Node: ExCreate245899
Node: ExDialog247199
Node: ExGrowing248470
Node: ExModifying249279
Node: ExBootable249789
Node: ExCharset250344
Node: ExPseudo251240
Node: ExCdrecord252167
Node: ExMkisofs252487
Node: ExGrowisofs253844
Node: ExException254998
Node: ExTime255456
Node: ExIncBackup255914
Node: ExRestore259940
Node: ExRecovery260886
Node: Files261458
Node: Seealso262792
Node: Bugreport263507
Node: Legal264098
Node: CommandIdx265110
Node: ConceptIdx282298
Node: Overview1405
Node: Model3442
Node: Media6346
Node: Methods9033
Node: Drives11619
Node: Extras15561
Node: Processing20029
Node: Dialog23664
Node: Commands25353
Node: ArgSort27030
Node: AqDrive28524
Node: Loading32638
Node: Insert52745
Node: SetInsert63329
Node: Manip72648
Node: CmdFind82607
Node: Filter100910
Node: Writing105532
Node: SetWrite115688
Node: Bootable140273
Node: Jigdo165009
Node: Charset169268
Node: Exception172597
Node: DialogCtl178726
Node: Inquiry181328
Node: Navigate190116
Node: Verify198411
Node: Restore208289
Node: Emulation216902
Node: Scripting227361
Node: Frontend235144
Node: Examples244770
Node: ExDevices245948
Node: ExCreate246609
Node: ExDialog247909
Node: ExGrowing249180
Node: ExModifying249989
Node: ExBootable250499
Node: ExCharset251054
Node: ExPseudo251950
Node: ExCdrecord252877
Node: ExMkisofs253197
Node: ExGrowisofs254554
Node: ExException255708
Node: ExTime256166
Node: ExIncBackup256624
Node: ExRestore260650
Node: ExRecovery261596
Node: Files262168
Node: Environ263502
Node: Seealso264194
Node: Bugreport264911
Node: Legal265502
Node: CommandIdx266514
Node: ConceptIdx283702

End Tag Table