"Fossies" - the Fresh Open Source Software Archive

Member "tzselect.8.txt" (25 Nov 2022, 3198 Bytes) of package /linux/misc/tzcode2022g.tar.gz:

As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the last Fossies "Diffs" side-by-side code changes report for "tzselect.8.txt": 2021e_vs_2022e.

    1 TZSELECT(8)                 System Manager's Manual                TZSELECT(8)
    2 
    3 NAME
    4        tzselect - select a timezone
    5 
    6 SYNOPSIS
    7        tzselect [ -c coord ] [ -n limit ] [ --help ] [ --version ]
    8 
    9 DESCRIPTION
   10        The tzselect program asks the user for information about the current
   11        location, and outputs the resulting timezone to standard output.  The
   12        output is suitable as a value for the TZ environment variable.
   13 
   14        All interaction with the user is done via standard input and standard
   15        error.
   16 
   17 OPTIONS
   18        -c coord
   19               Instead of asking for continent and then country and then city,
   20               ask for selection from time zones whose largest cities are
   21               closest to the location with geographical coordinates coord.
   22               Use ISO 6709 notation for coord, that is, a latitude immediately
   23               followed by a longitude.  The latitude and longitude should be
   24               signed integers followed by an optional decimal point and
   25               fraction: positive numbers represent north and east, negative
   26               south and west.  Latitudes with two and longitudes with three
   27               integer digits are treated as degrees; latitudes with four or
   28               six and longitudes with five or seven integer digits are treated
   29               as DDMM, DDDMM, DDMMSS, or DDDMMSS representing DD or DDD
   30               degrees, MM minutes, and zero or SS seconds, with any trailing
   31               fractions represent fractional minutes or (if SS is present)
   32               seconds.  The decimal point is that of the current locale.  For
   33               example, in the (default) C locale, -c +40.689-074.045 specifies
   34               40.689 degrees N, 74.045 degrees W, -c +4041.4-07402.7 specifies
   35               40 degrees 41.4 minutes N, 74 degrees 2.7 minutes W, and
   36               -c +404121-0740240 specifies 40 degrees 41 minutes 21 seconds N,
   37               74 degrees 2 minutes 40 seconds W.  If coord is not one of the
   38               documented forms, the resulting behavior is unspecified.
   39 
   40        -n limit
   41               When -c is used, display the closest limit locations (default
   42               10).
   43 
   44        --help Output help information and exit.
   45 
   46        --version
   47               Output version information and exit.
   48 
   49 ENVIRONMENT VARIABLES
   50        AWK    Name of a Posix-compliant awk program (default: awk).
   51 
   52        TZDIR  Name of the directory containing timezone data files (default:
   53               /usr/share/zoneinfo).
   54 
   55 FILES
   56        TZDIR/iso3166.tab
   57               Table of ISO 3166 2-letter country codes and country names.
   58 
   59        TZDIR/zone1970.tab
   60               Table of country codes, latitude and longitude, timezones, and
   61               descriptive comments.
   62 
   63        TZDIR/TZ
   64               Timezone data file for timezone TZ.
   65 
   66 EXIT STATUS
   67        The exit status is zero if a timezone was successfully obtained from
   68        the user, nonzero otherwise.
   69 
   70 SEE ALSO
   71        newctime(3), tzfile(5), zdump(8), zic(8)
   72 
   73 NOTES
   74        Applications should not assume that tzselect's output matches the
   75        user's political preferences.
   76 
   77                                                                    TZSELECT(8)