usr/src/man/man4/timezone.4

   1 '\" te
   2 .\"  Copyright (c) 2003, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH TIMEZONE 4 "Feb 18, 2003"
   7 .SH NAME
   8 timezone \- default timezone data base
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/etc/timezone\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The timezone file contains information regarding the default timezone for each
  19 host in a domain. Alternatively, a single default line for the entire domain
  20 may be specified. Each entry has the format:
  21 .sp
  22 .in +2
  23 .nf
  24 \fITimezone-name    official-host-or-domain-name\fR
  25 .fi
  26 .in -2
  27
  28 .sp
  29 .LP
  30 Items are separated by any number of blanks and/or TAB characters. A `#'
  31 indicates the beginning of a comment; characters up to the end of the line are
  32 not interpreted by routines which search the file. The timezone is a pathname
  33 relative to the directory \fB/usr/share/lib/zoneinfo\fR.
  34 .sp
  35 .LP
  36 This file is not actually referenced by any system software; it is merely used
  37 as a source file to construct the \fBNIS\fR \fBtimezone.byname\fR map. This map
  38 is read by \fBsysidtool\fR(1M) to initialize the timezone of the client system
  39 at installation time. For more information, see the \fISolaris Express
  40 Installation Guide: Basic Installations\fR.
  41 .sp
  42 .LP
  43 The \fBtimezone\fR file does not set the timezone environment variable
  44 \fBTZ\fR. See \fBTIMEZONE\fR(4) for information to set the \fBTZ\fR environment
  45 variable.
  46 .SH EXAMPLES
  47 .LP
  48 \fBExample 1 \fRTypical timezone line
  49 .sp
  50 .LP
  51 Here is a typical line from the \fB/etc/timezone\fR file:
  52
  53 .sp
  54 .in +2
  55 .nf
  56 US/Eastern          East.Sun.COM #Sun East Coast
  57 .fi
  58 .in -2
  59 .sp
  60
  61 .SH FILES
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fB/etc/timezone\fR\fR
  66 .ad
  67 .RS 17n
  68
  69 .RE
  70
  71 .SH SEE ALSO
  72 .sp
  73 .LP
  74 \fBsysidtool\fR(1M), \fBTIMEZONE\fR(4)
  75 .sp
  76 .LP
  77 \fISolaris Express Installation Guide: Basic Installations\fR