summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2019-08-02 11:41:36 +0200
committerDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2019-08-02 11:41:36 +0200
commit402fc5a6000bf0ec12f05d4aa2b3e250ec85a60a (patch)
tree7d9a1b7bc77cbd0211e3e4cb31c079778207453a /doc
parenteddb62072f4d4d2402d520e5041d9677fa6efdff (diff)
Implement support for SOURCE_DATE_EPOCH environment variable
reproducible-builds.org suggests the use of an environment variable as a source for time stamps: https://reproducible-builds.org/specs/source-date-epoch/ This commit adds support for setting the default mtime from the variable, if it is set and only defaulting to 0 if not. The timestamp given by the command line switch takes precedence. Signed-off-by: David Oberhollenzer <david.oberhollenzer@sigma-star.at>
Diffstat (limited to 'doc')
-rw-r--r--doc/gensquashfs.19
-rw-r--r--doc/tar2sqfs.19
2 files changed, 16 insertions, 2 deletions
diff --git a/doc/gensquashfs.1 b/doc/gensquashfs.1
index d7b78a1..ab729d7 100644
--- a/doc/gensquashfs.1
+++ b/doc/gensquashfs.1
@@ -58,7 +58,7 @@ rd.
uid=<value>;0
gid=<value>;0
mode=<value>;0755
-mtime=<value>;0
+mtime=<value>;\fB$SOURCE\_DATE\_EPOCH\fR if set, 0 otherwise
.TE
.TP
.TP
@@ -148,6 +148,13 @@ file /bin/bash 0755 0 0
file "/opt/my app/\\"special\\"/data" 0600 0 0
.fi
.in
+.SH ENVIRONEMNT VARIABLES
+If the command line switch \fB\-\-defaults\fR is not used or no default mtime
+is specified, the value of the environment variable \fBSOURCE\_DATE\_EPOCH\fR
+is used for all file and filesystem timestamps.
+
+If \fBSOURCE\_DATE\_EPOCH\fR is not set, not a parsable number or it is out of
+range, the timestamps default to 0.
.SH AUTHOR
Written by David Oberhollenzer.
.SH COPYRIGHT
diff --git a/doc/tar2sqfs.1 b/doc/tar2sqfs.1
index 76178bf..7965a26 100644
--- a/doc/tar2sqfs.1
+++ b/doc/tar2sqfs.1
@@ -52,7 +52,7 @@ rd.
uid=<value>;0
gid=<value>;0
mode=<value>;0755
-mtime=<value>;0
+mtime=<value>;\fB$SOURCE\_DATE\_EPOCH\fR if set, 0 otherwise
.TE
.TP
.TP
@@ -95,6 +95,13 @@ If any unsupported section or extended attribute key is encountered in an
archive a warning message is written to stderr. If the \fB\-\-no\-skip\fR
option is set, processing aborts. By default, unknown sections and unsupported
extended attributes are simply skipped after issuing a warning.
+.SH ENVIRONEMNT VARIABLES
+If the command line switch \fB\-\-defaults\fR is not used or no default mtime
+is specified, the value of the environment variable \fBSOURCE\_DATE\_EPOCH\fR
+is used for all file and filesystem timestamps.
+
+If \fBSOURCE\_DATE\_EPOCH\fR is not set, not a parsable number or it is out of
+range, the timestamps default to 0.
.SH EXAMPLES
.TP
Turn an uncompressed tar archive into a squashfs image: