New environment variable SOURCE_DATE_EPOCH

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.4.5, Aug 14, 2016"
+@c man .TH XORRISO 1 "Version 1.4.5, Aug 15, 2016"
 @c man .\" Please adjust this date whenever revising the manpage.
 @c man .\"
 @c man .\" Some roff macros, for reference:
@@ -105,6 +105,7 @@ with Rock Ridge extensions.
 * Commands::            Reference of commands
 * Examples::            Examples
 * Files::               Files
+* Environ::             Environment
 * Seealso::             See also
 * Bugreport::           Reporting bugs
 * Legal::               Author, Copyright, Credits
@@ -3304,7 +3305,16 @@ Available types are:
 @*
 "f"  time since when the volume is effectively valid.
 @*
-"uuid"  sets a timestring that overrides "c" and "m" times literally.
+"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:
@@ -4794,6 +4804,10 @@ mentioned boot facilities.
 Modes @strong{cmd} and @strong{as_mkisofs} work like with
 command -report_el_torito. See above.
 @*
+With mode @strong{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 @strong{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 number is shown like "0x690fd979".
@@ -6929,7 +6943,7 @@ This can be repeated several times, if necessary with -eject or with other
 addresses which can be used on "$HOME"/dvd_copy with mount option -o sbsector=
 or -s.
 @c man .SH FILES
-@node Files, Seealso, Examples, Top 
+@node Files, Environ, Examples, Top 
 @chapter Files
 @c man .SS 
 @c man .B Program alias names:
@@ -6978,6 +6992,25 @@ The default setting of -check_media abort_file= is:
 @sp 1
    /var/opt/xorriso/do_abort_check_media
 @*
+@sp 1
+@c man .SS
+@c man .SH ENVIRONMENT
+@node Environ, Seealso, Files, Top
+@chapter 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.
+@*
+@sp 1
+@c man .SS
 @c man .SH SEE ALSO
 @c man .TP
 @c man For the mkisofs emulation of xorriso
@@ -7016,7 +7049,7 @@ The default setting of -check_media abort_file= is:
 @c man .BR setextattr(8),
 @c man .BR md5(1)
 @c man-ignore-lines begin
-@node Seealso, Bugreport, Files, Top 
+@node Seealso, Bugreport, Environ, Top 
 @chapter See also
 @table @asis
 @item For the mkisofs emulation of @command{xorriso}