84d9c625bf
- Fix for possible unset uid/gid in toproto
- Fix for default mtree style
- Update libelf
- Importing libexecinfo
- Resynchronize GCC, mpc, gmp, mpfr
- build.sh: Replace params with show-params.
This has been done as the make target has been renamed in the same
way, while a new target named params has been added. This new
target generates a file containing all the parameters, instead of
printing it on the console.
- Update test48 with new etc/services (Fix by Ben Gras <ben@minix3.org)
get getservbyport() out of the inner loop
Change-Id: Ie6ad5226fa2621ff9f0dee8782ea48f9443d2091
115 lines
2.9 KiB
Groff
115 lines
2.9 KiB
Groff
.\" $NetBSD: tzselect.8,v 1.5 2013/09/20 19:06:54 christos Exp $
|
|
.\"
|
|
.TH TZSELECT 8
|
|
.SH NAME
|
|
tzselect \- select a time zone
|
|
.SH SYNOPSIS
|
|
.B tzselect
|
|
[
|
|
.B \-c
|
|
.I coord
|
|
] [
|
|
.B \-n
|
|
.I limit
|
|
] [
|
|
.B \-\-help
|
|
] [
|
|
.B \-\-version
|
|
]
|
|
.SH DESCRIPTION
|
|
The
|
|
.B tzselect
|
|
program asks the user for information about the current location,
|
|
and outputs the resulting time zone description to standard output.
|
|
The output is suitable as a value for the TZ environment variable.
|
|
.PP
|
|
All interaction with the user is done via standard input and standard error.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BI "\-c " coord
|
|
Instead of asking for continent and then country and then city,
|
|
ask for selection from time zones whose largest cities
|
|
are closest to the location with geographical coordinates
|
|
.I coord.
|
|
Use ISO 6709 notation for
|
|
.I coord,
|
|
that is, a latitude immediately followed by a longitude. The latitude
|
|
and longitude should be signed integers followed by an optional
|
|
decimal point and fraction: positive numbers represent north and east,
|
|
negative south and west. Latitudes with two and longitudes with three
|
|
integer digits are treated as degrees; latitudes with four or six and
|
|
longitudes with five or seven integer digits are treated as
|
|
.I "DDMM, DDDMM, DDMMSS,"
|
|
or
|
|
.I DDDMMSS
|
|
representing
|
|
.I DD
|
|
or
|
|
.I DDD
|
|
degrees,
|
|
.I MM
|
|
minutes,
|
|
and zero or
|
|
.I SS
|
|
seconds, with any trailing fractions represent fractional minutes or
|
|
(if
|
|
.I SS
|
|
is present) seconds. The decimal point is that of the current locale.
|
|
For example, in the (default) C locale,
|
|
.B "\-c\ +40.689\-074.045"
|
|
specifies 40.689\(de\|N, 74.045\(de\|W,
|
|
.B "\-c\ +4041.4\-07402.7"
|
|
specifies 40\(de\|41.4\(fm\|N, 74\(de\|2.7\(fm\|W, and
|
|
.B "\-c\ +404121\-0740240"
|
|
specifies 40\(de\|41\(fm\|21\(sd\|N, 74\(de\|2\(fm\|40\(sd\|W.
|
|
If
|
|
.I coord
|
|
is not one of the documented forms, the resulting behavior is unspecified.
|
|
.TP
|
|
.BI "\-n " limit
|
|
When
|
|
.B \-c
|
|
is used, display the closest
|
|
.I limit
|
|
locations (default 10).
|
|
.PP
|
|
Applications should not assume that
|
|
.BR tzselect 's
|
|
output matches the user's political preferences.
|
|
.RE
|
|
.TP
|
|
.B "\-\-help"
|
|
Output help information and exit.
|
|
.TP
|
|
.B "\-\-version"
|
|
Output version information and exit.
|
|
.SH "ENVIRONMENT VARIABLES"
|
|
.TP
|
|
\f3AWK\fP
|
|
Name of a Posix-compliant
|
|
.I awk
|
|
program (default:
|
|
.BR awk ).
|
|
.TP
|
|
\f3TZDIR\fP
|
|
Name of the directory containing time zone data files (default:
|
|
.BR /usr/local/etc/zoneinfo ).
|
|
.SH FILES
|
|
.TP
|
|
\f2TZDIR\fP\f3/iso3166.tab\fP
|
|
Table of ISO 3166 2-letter country codes and country names.
|
|
.TP
|
|
\f2TZDIR\fP\f3/zone.tab\fP
|
|
Tables of country codes, latitude and longitude, zone names, and
|
|
descriptive comments.
|
|
.TP
|
|
\f2TZDIR\fP\f3/\fP\f2TZ\fP
|
|
Time zone data file for time zone \f2TZ\fP.
|
|
.SH "EXIT STATUS"
|
|
The exit status is zero if a time zone was successfully obtained from the user,
|
|
nonzero otherwise.
|
|
.SH "SEE ALSO"
|
|
newctime(3), tzfile(5), zdump(8), zic(8)
|
|
.\" @(#)tzselect.8 8.2
|
|
.\" This file is in the public domain, so clarified as of
|
|
.\" 2009-05-17 by Arthur David Olson.
|