From 8507c377dbac1a90cbec601f9bd954573c336a09 Mon Sep 17 00:00:00 2001 From: emaste Date: Tue, 16 May 2017 19:03:26 +0000 Subject: [PATCH] newfs_msdos: clarify description of -T (timestamp) option Submitted by: Siva Mahadevan Reported by: Daniel Shahaf Reviewed by: emaste Sponsored by: The FreeBSD Foundation --- sbin/newfs_msdos/newfs_msdos.8 | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/sbin/newfs_msdos/newfs_msdos.8 b/sbin/newfs_msdos/newfs_msdos.8 index 44d5f21426b4..a5e9b956b5f8 100644 --- a/sbin/newfs_msdos/newfs_msdos.8 +++ b/sbin/newfs_msdos/newfs_msdos.8 @@ -38,10 +38,11 @@ .Op Fl B Ar boot .Op Fl C Ar create-size .Op Fl F Ar FAT-type -.Op Fl I Ar VolumeId +.Op Fl I Ar VolumeID .Op Fl L Ar label .Op Fl O Ar OEM .Op Fl S Ar sector-size +.Op Fl T Ar timestamp .Op Fl a Ar FAT-size .Op Fl b Ar block-size .Op Fl c Ar cluster-size @@ -55,7 +56,6 @@ .Op Fl o Ar hidden .Op Fl r Ar reserved .Op Fl s Ar total -.Op Fl T Ar timestamp .Op Fl u Ar track-size .Ar special .Op Ar disktype @@ -118,6 +118,14 @@ The default is Number of bytes per sector. Acceptable values are powers of 2 in the range 512 through 32768, inclusive. +.It Fl T Ar timestamp +Create the filesystem as though the current time is +.Ar timestamp . +The default filesystem volume ID is derived from the time. +.Ar timestamp +can be a pathname (where the timestamp is derived from +that file) or an integer value interpreted +as the number of seconds since the Epoch. .It Fl a Ar FAT-size Number of sectors per FAT. .It Fl b Ar block-size @@ -160,17 +168,11 @@ Number of hidden sectors. Number of reserved sectors. .It Fl s Ar total File system size. -.It Fl T Ar timestamp -Specify a timestamp to be used for filesystem creation so that -it can be consistent for reproducible builds. -The timestamp can be a pathname (where the timestamps are derived from -that file) or an integer value interpreted -as the number of seconds since the Epoch. .It Fl u Ar track-size Number of sectors per track. .El .Sh NOTES -If some parameters (e.g. size, number of sectors, etc.) are not specified +If some parameters (e.g., size, number of sectors, etc.) are not specified through options or disktype, the program tries to generate them automatically. In particular, the size is determined as the device or file size minus the offset specified with the