lib/libc/time/tzselect.8

   1 .\"     $NetBSD: tzselect.8,v 1.4 2009/12/31 22:49:16 mlelstv Exp $
   2 .\"
   3 .TH TZSELECT 8
   4 .SH NAME
   5 tzselect \- select a time zone
   6 .SH SYNOPSIS
   7 .B tzselect
   8 .SH DESCRIPTION
   9 The
  10 .B tzselect
  11 program asks the user for information about the current location,
  12 and outputs the resulting time zone description to standard output.
  13 The output is suitable as a value for the TZ environment variable.
  14 .PP
  15 All interaction with the user is done via standard input and standard error.
  16 .SH "ENVIRONMENT VARIABLES"
  17 .TP
  18 \f3AWK\fP
  19 Name of a Posix-compliant
  20 .I awk
  21 program (default:
  22 .BR awk ).
  23 .TP
  24 \f3TZDIR\fP
  25 Name of the directory containing time zone data files (default:
  26 .BR /usr/local/etc/zoneinfo ).
  27 .SH FILES
  28 .TP
  29 \f2TZDIR\fP\f3/iso3166.tab\fP
  30 Table of ISO 3166 2-letter country codes and country names.
  31 .TP
  32 \f2TZDIR\fP\f3/zone.tab\fP
  33 Table of country codes, latitude and longitude, TZ values, and
  34 descriptive comments.
  35 .TP
  36 \f2TZDIR\fP\f3/\fP\f2TZ\fP
  37 Time zone data file for time zone \f2TZ\fP.
  38 .SH "EXIT STATUS"
  39 The exit status is zero if a time zone was successfully obtained from the user,
  40 nonzero otherwise.
  41 .SH "SEE ALSO"
  42 newctime(3), tzfile(5), zdump(8), zic(8)
  43 .\" @(#)tzselect.8      8.2
  44 .\" This file is in the public domain, so clarified as of
  45 .\" 2009-05-17 by Arthur David Olson.