diff options
Diffstat (limited to 'zic.8')
| -rw-r--r-- | zic.8 | 56 |
1 files changed, 46 insertions, 10 deletions
@@ -22,8 +22,6 @@ zic \- timezone compiler .el .ds < \(la .ie '\(ra'' .ds > > .el .ds > \(ra -.ie \n(.g .ds : \: -.el .ds : . .ds d " degrees .ds m " minutes .ds s " seconds @@ -63,7 +61,7 @@ is .BR fat , generate additional data entries that work around potential bugs or incompatibilities in older software, such as software that mishandles -the 64-bit generated data. +a TZif file's 64-bit data or proleptic TZ string. If .I bloat is @@ -72,12 +70,19 @@ keep the output files small; this can help check for the bugs and incompatibilities. The default is .BR slim , -as software that mishandles 64-bit data typically -mishandles timestamps after the year 2038 anyway. +as the +.B fat +workarounds are typically good only until the year 2038 anyway. Also see the .B \-r option for another way to alter output size. .TP +.BI \-D +Do not create ancestor directories of output files, +For example, for a zone named America/Los_Angeles +the directory America should already exist. +By default, the directory and its ancestors are created +if they do not already exist. .BI "\-d " directory Create time conversion information files in the named directory rather than in the standard directory named below. @@ -132,6 +137,19 @@ if .IR timezone 's transitions are at standard time or Universal Time (UT) instead of local time. .TP +.BI "\-m " mode +Create TZif files with the given file mode bits. +By default the files are created with mode 644 as modified by the umask. +With this option they are created with the given mode instead. +For portability the mode should be an unsigned octal integer, +typically 644 or 444; +some platforms also support +.BR chmod (1)-style +symbolic modes. +This option does not affect created ancestor directories, +which have mode 755 as modified by the umask. +The option is ignored on platforms lacking the notion of file mode bits. +.TP .BR "\-r " "[\fB@\fP\fIlo\fP][\fB/@\fP\fIhi\fP]" Limit the applicability of output files to timestamps in the range from @@ -185,6 +203,19 @@ it increases the size of the altered output files. When creating local time information, put the configuration link in the named file rather than in the standard location. .TP +.BI "\-u " owner\fR[:\fPgroup\fR]\fP +Change the output regular files' owner and group to those specified. +The +.I owner +is either a user name, or an unsigned decimal integer user ID, +or an empty string meaning no change to the owner. +The +.I group +is similar for group names and IDs. +This option does not affect directories or hard or symbolic links. +It typically needs special privileges to change ownership, +and is ignored on platforms that lack the notions of owners and groups. +.TP .B \-v Be more verbose, and complain about the following situations: .RS @@ -288,8 +319,10 @@ zero or more lines, each ending in a newline byte and containing at most 2048 bytes counting the newline, and without any NUL bytes. The input text's encoding is typically UTF-8 or ASCII; it should have a unibyte representation -for the POSIX Portable Character Set (PPCS) -\*<https://pubs\*:.opengroup\*:.org/\*:onlinepubs/\*:9699919799/\*:basedefs/\*:V1_chap06\*:.html\*> +for the +.UR https://\:pubs\:.opengroup\:.org/\:onlinepubs/\:9799919799/\:basedefs/\:V1_chap06\:.html +POSIX Portable Character Set (PPCS) +.UE and the encoding's non-unibyte characters should consist entirely of non-PPCS bytes. Non-PPCS characters typically occur only in comments: although output file names and time zone abbreviations can contain @@ -681,11 +714,14 @@ Zone America/Menominee \-5:00 \- EST 1973 Apr 29 2:00 .in .fi Here, an incorrect reading would be there were two clock changes on 1973-04-29, -the first from 02:00 EST (\-05) to 01:00 CST (\-06), -and the second an hour later from 02:00 CST (\-06) to 03:00 CDT (\-05). +the first from 02:00 EST (\-05) to 01:00 CST (\-06) according to the +.q "until" +value in the zone line, +and the second an hour later from 02:00 CST (\-06) to 03:00 CDT (\-05) +according to the values in the April rule line. However, .B zic -interprets this more sensibly as a single transition from 02:00 CST (\-05) to +interprets this more sensibly as a single transition from 02:00 EST (\-05) to 02:00 CDT (\-05). .PP A link line has the form |