Return to zic.8 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / zoneinfo

Annotation of 43BSDReno/share/zoneinfo/zic.8, revision 1.1

1.1     ! root        1: .TH ZIC 8
        !             2: .SH NAME
        !             3: zic \- time zone compiler
        !             4: .SH SYNOPSIS
        !             5: .B zic
        !             6: [
        !             7: .B \-v
        !             8: ] [
        !             9: .B \-d
        !            10: .I directory
        !            11: ] [
        !            12: .B \-l
        !            13: .I localtime
        !            14: ] [
        !            15: .B \-p
        !            16: .I posixrules
        !            17: ] [
        !            18: .B \-L
        !            19: .I leapsecondfilename
        !            20: ] [
        !            21: .B \-s
        !            22: ] [
        !            23: .I filename
        !            24: \&... ]
        !            25: .SH DESCRIPTION
        !            26: .if t .ds lq ``
        !            27: .if t .ds rq ''
        !            28: .if n .ds lq \&"\"
        !            29: .if n .ds rq \&"\"
        !            30: .de q
        !            31: \\$3\*(lq\\$1\*(rq\\$2
        !            32: ..
        !            33: .I Zic
        !            34: reads text from the file(s) named on the command line
        !            35: and creates the time conversion information files specified in this input.
        !            36: If a
        !            37: .I filename
        !            38: is
        !            39: .BR \- ,
        !            40: the standard input is read.
        !            41: .PP
        !            42: These options are available:
        !            43: .TP
        !            44: .BI "\-d " directory
        !            45: Create time conversion information files in the named directory rather than
        !            46: in the standard directory named below.
        !            47: .TP
        !            48: .BI "\-l " timezone
        !            49: Use the given time zone as local time.
        !            50: .I Zic
        !            51: will act as if the input contained a link line of the form
        !            52: .sp
        !            53: .ti +.5i
        !            54: Link   \fItimezone\fP          localtime
        !            55: .TP
        !            56: .BI "\-p " timezone
        !            57: Use the given time zone's rules when handling POSIX-format
        !            58: time zone environment variables.
        !            59: .I Zic
        !            60: will act as if the input contained a link line of the form
        !            61: .sp
        !            62: .ti +.5i
        !            63: Link   \fItimezone\fP          posixrules
        !            64: .TP
        !            65: .BI "\-L " leapsecondfilename
        !            66: Read leap second information from the file with the given name.
        !            67: If this option is not used,
        !            68: no leap second information appears in output files.
        !            69: .TP
        !            70: .B \-v
        !            71: Complain if a year that appears in a data file is outside the range
        !            72: of years representable by
        !            73: .IR time (2)
        !            74: values.
        !            75: .TP
        !            76: .B \-s
        !            77: Limit time values stored in output files to values that are the same
        !            78: whether they're taken to be signed or unsigned.
        !            79: You can use this option to generate SVVS-compatible files.
        !            80: .sp
        !            81: Input lines are made up of fields.
        !            82: Fields are separated from one another by any number of white space characters.
        !            83: Leading and trailing white space on input lines is ignored.
        !            84: An unquoted sharp character (#) in the input introduces a comment which extends
        !            85: to the end of the line the sharp character appears on.
        !            86: White space characters and sharp characters may be enclosed in double quotes
        !            87: (") if they're to be used as part of a field.
        !            88: Any line that is blank (after comment stripping) is ignored.
        !            89: Non-blank lines are expected to be of one of three types:
        !            90: rule lines, zone lines, and link lines.
        !            91: .PP
        !            92: A rule line has the form
        !            93: .nf
        !            94: .B
        !            95: .ti +.5i
        !            96: .ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'TYPE\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u
        !            97: .sp
        !            98: Rule   NAME    FROM    TO      TYPE    IN      ON      AT      SAVE    LETTER/S
        !            99: .sp
        !           100: For example:
        !           101: .ti +.5i
        !           102: .sp
        !           103: Rule   USA     1969    1973    \-      Apr     lastSun 2:00    1:00    D
        !           104: .sp
        !           105: .fi
        !           106: The fields that make up a rule line are:
        !           107: .TP "\w'LETTER/S'u"
        !           108: .B NAME
        !           109: Gives the (arbitrary) name of the set of rules this rule is part of.
        !           110: .TP
        !           111: .B FROM
        !           112: Gives the first year in which the rule applies.
        !           113: The word
        !           114: .B minimum
        !           115: (or an abbreviation) means the minimum year with a representable time value.
        !           116: The word
        !           117: .B maximum
        !           118: (or an abbreviation) means the maximum year with a representable time value.
        !           119: .TP
        !           120: .B TO
        !           121: Gives the final year in which the rule applies.
        !           122: In addition to
        !           123: .B minimum
        !           124: and
        !           125: .B maximum
        !           126: (as above),
        !           127: the word
        !           128: .B only
        !           129: (or an abbreviation)
        !           130: may be used to repeat the value of the
        !           131: .B FROM
        !           132: field.
        !           133: .TP
        !           134: .B TYPE
        !           135: Gives the type of year in which the rule applies.
        !           136: If
        !           137: .B TYPE
        !           138: is
        !           139: .B \-
        !           140: then the rule applies in all years between
        !           141: .B FROM
        !           142: and
        !           143: .B TO
        !           144: inclusive;
        !           145: if
        !           146: .B TYPE
        !           147: is
        !           148: .BR uspres ,
        !           149: the rule applies in U.S. Presidential election years;
        !           150: if
        !           151: .B TYPE
        !           152: is
        !           153: .BR nonpres ,
        !           154: the rule applies in years other than U.S. Presidential election years.
        !           155: If
        !           156: .B TYPE
        !           157: is something else, then
        !           158: .I zic
        !           159: executes the command
        !           160: .ti +.5i
        !           161: \fByearistype\fP \fIyear\fP \fItype\fP
        !           162: .br
        !           163: to check the type of a year:
        !           164: an exit status of zero is taken to mean that the year is of the given type;
        !           165: an exit status of one is taken to mean that the year is not of the given type.
        !           166: .TP
        !           167: .B IN
        !           168: Names the month in which the rule takes effect.
        !           169: Month names may be abbreviated.
        !           170: .TP
        !           171: .B ON
        !           172: Gives the day on which the rule takes effect.
        !           173: Recognized forms include:
        !           174: .nf
        !           175: .in +.5i
        !           176: .sp
        !           177: .ta \w'Sun<=25\0\0'u
        !           178: 5      the fifth of the month
        !           179: lastSun        the last Sunday in the month
        !           180: lastMon        the last Monday in the month
        !           181: Sun>=8 first Sunday on or after the eighth
        !           182: Sun<=25        last Sunday on or before the 25th
        !           183: .fi
        !           184: .in -.5i
        !           185: .sp
        !           186: Names of days of the week may be abbreviated or spelled out in full.
        !           187: Note that there must be no spaces within the
        !           188: .B ON
        !           189: field.
        !           190: .TP
        !           191: .B AT
        !           192: Gives the time of day at which the rule takes effect.
        !           193: Recognized forms include:
        !           194: .nf
        !           195: .in +.5i
        !           196: .sp
        !           197: .ta \w'1:28:13\0\0'u
        !           198: 2      time in hours
        !           199: 2:00   time in hours and minutes
        !           200: 15:00  24-hour format time (for times after noon)
        !           201: 1:28:14        time in hours, minutes, and seconds
        !           202: .fi
        !           203: .in -.5i
        !           204: .sp
        !           205: Any of these forms may be followed by the letter
        !           206: .B w
        !           207: if the given time is local
        !           208: .q "wall clock"
        !           209: time or
        !           210: .B s
        !           211: if the given time is local
        !           212: .q standard
        !           213: time; in the absence of
        !           214: .B w
        !           215: or
        !           216: .BR s ,
        !           217: wall clock time is assumed.
        !           218: .TP
        !           219: .B SAVE
        !           220: Gives the amount of time to be added to local standard time when the rule is in
        !           221: effect.
        !           222: This field has the same format as the
        !           223: .B AT
        !           224: field
        !           225: (although, of course, the
        !           226: .B w
        !           227: and
        !           228: .B s
        !           229: suffixes are not used).
        !           230: .TP
        !           231: .B LETTER/S
        !           232: Gives the
        !           233: .q "variable part"
        !           234: (for example, the
        !           235: .q S
        !           236: or
        !           237: .q D
        !           238: in
        !           239: .q EST
        !           240: or
        !           241: .q EDT )
        !           242: of time zone abbreviations to be used when this rule is in effect.
        !           243: If this field is
        !           244: .BR \- ,
        !           245: the variable part is null.
        !           246: .PP
        !           247: A zone line has the form
        !           248: .sp
        !           249: .nf
        !           250: .ti +.5i
        !           251: .ta \w'Zone\0\0'u +\w'Australia/South\-west\0\0'u +\w'GMTOFF\0\0'u +\w'RULES/SAVE\0\0'u +\w'FORMAT\0\0'u
        !           252: Zone   NAME    GMTOFF  RULES/SAVE      FORMAT  [UNTIL]
        !           253: .sp
        !           254: For example:
        !           255: .sp
        !           256: .ti +.5i
        !           257: Zone   Australia/South\-west   9:30    Aus     CST     1987 Mar 15 2:00
        !           258: .sp
        !           259: .fi
        !           260: The fields that make up a zone line are:
        !           261: .TP "\w'GMTOFF'u"
        !           262: .B NAME
        !           263: The name of the time zone.
        !           264: This is the name used in creating the time conversion information file for the
        !           265: zone.
        !           266: .TP
        !           267: .B GMTOFF
        !           268: The amount of time to add to GMT to get standard time in this zone.
        !           269: This field has the same format as the
        !           270: .B AT
        !           271: and
        !           272: .B SAVE
        !           273: fields of rule lines;
        !           274: begin the field with a minus sign if time must be subtracted from GMT.
        !           275: .TP
        !           276: .B RULES/SAVE
        !           277: The name of the rule(s) that apply in the time zone or,
        !           278: alternately, an amount of time to add to local standard time.
        !           279: If this field is
        !           280: .B \-
        !           281: then standard time always applies in the time zone.
        !           282: .TP
        !           283: .B FORMAT
        !           284: The format for time zone abbreviations in this time zone.
        !           285: The pair of characters
        !           286: .B %s
        !           287: is used to show where the
        !           288: .q "variable part"
        !           289: of the time zone abbreviation goes.
        !           290: .TP
        !           291: .B UNTIL
        !           292: The time at which the GMT offset or the rule(s) change for a location.
        !           293: It is specified as a year, a month, a day, and a time of day.
        !           294: If this is specified,
        !           295: the time zone information is generated from the given GMT offset
        !           296: and rule change until the time specified.
        !           297: .IP
        !           298: The next line must be a
        !           299: .q continuation
        !           300: line; this has the same form as a zone line except that the
        !           301: string
        !           302: .q Zone
        !           303: and the name are omitted, as the continuation line will
        !           304: place information starting at the time specified as the
        !           305: .B UNTIL
        !           306: field in the previous line in the file used by the previous line.
        !           307: Continuation lines may contain an
        !           308: .B UNTIL
        !           309: field, just as zone lines do, indicating that the next line is a further
        !           310: continuation.
        !           311: .PP
        !           312: A link line has the form
        !           313: .sp
        !           314: .nf
        !           315: .ti +.5i
        !           316: .if t .ta \w'Link\0\0'u +\w'LINK-FROM\0\0'u
        !           317: .if n .ta \w'Link\0\0'u +\w'US/Eastern\0\0'u
        !           318: Link   LINK-FROM       LINK-TO
        !           319: .sp
        !           320: For example:
        !           321: .sp
        !           322: .ti +.5i
        !           323: Link   US/Eastern      EST5EDT
        !           324: .sp
        !           325: .fi
        !           326: The
        !           327: .B LINK-FROM
        !           328: field should appear as the
        !           329: .B NAME
        !           330: field in some zone line;
        !           331: the
        !           332: .B LINK-TO
        !           333: field is used as an alternate name for that zone.
        !           334: .PP
        !           335: Except for continuation lines,
        !           336: lines may appear in any order in the input.
        !           337: .PP
        !           338: Lines in the file that describes leap seconds have the following form:
        !           339: .nf
        !           340: .B
        !           341: .ti +.5i
        !           342: .ta \w'Leap\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u +\w'HH:MM:SS\0\0'u +\w'CORR\0\0'u
        !           343: Leap   YEAR    MONTH   DAY     HH:MM:SS        CORR    R/S
        !           344: .sp
        !           345: For example:
        !           346: .ti +.5i
        !           347: .sp
        !           348: Leap   1974    Dec     31      23:59:60        +       S
        !           349: .sp
        !           350: .fi
        !           351: The 
        !           352: .BR YEAR ,
        !           353: .BR MONTH ,
        !           354: .BR DAY ,
        !           355: and
        !           356: .B HH:MM:SS
        !           357: fields tell when the leap second happened.
        !           358: The
        !           359: .B CORR
        !           360: field
        !           361: should be
        !           362: .q +
        !           363: if a second was added
        !           364: or 
        !           365: .q -
        !           366: if a second was skipped.
        !           367: The
        !           368: .B R/S
        !           369: field
        !           370: should be (an abbreviation of)
        !           371: .q Stationary
        !           372: if the leap second time given by the other fields should be interpreted as GMT
        !           373: or
        !           374: (an abbreviation of)
        !           375: .q Rolling
        !           376: if the leap second time given by the other fields should be interpreted as
        !           377: local wall clock time.
        !           378: .SH NOTE
        !           379: For areas with more than two types of local time,
        !           380: you may need to use local standard time in the
        !           381: .B AT
        !           382: field of the earliest transition time's rule to ensure that
        !           383: the earliest transition time recorded in the compiled file is correct.
        !           384: .SH FILE
        !           385: /etc/zoneinfo  standard directory used for created files
        !           386: .SH "SEE ALSO"
        !           387: newctime(3), tzfile(5), zdump(8)
        !           388: .. @(#)zic.8   4.4

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.