release/src/router/mysql/man/mysql_tzinfo_to_sql.1

   1 '\" t
   2 .\"     Title: \fBmysql_tzinfo_to_sql\fR
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.77.1 <http://docbook.sf.net/>
   5 .\"      Date: 11/04/2013
   6 .\"    Manual: MySQL Database System
   7 .\"    Source: MySQL 5.1
   8 .\"  Language: English
   9 .\"
  10 .TH "\FBMYSQL_TZINFO_TO_S" "1" "11/04/2013" "MySQL 5\&.1" "MySQL Database System"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .\" mysql_tzinfo_to_sql
  31 .\" time zone tables
  32 .SH "NAME"
  33 mysql_tzinfo_to_sql \- load the time zone tables
  34 .SH "SYNOPSIS"
  35 .HP \w'\fBmysql_tzinfo_to_sql\ \fR\fB\fIarguments\fR\fR\ 'u
  36 \fBmysql_tzinfo_to_sql \fR\fB\fIarguments\fR\fR
  37 .SH "DESCRIPTION"
  38 .PP
  39 The
  40 \fBmysql_tzinfo_to_sql\fR
  41 program loads the time zone tables in the
  42 mysql
  43 database\&. It is used on systems that have a
  44 zoneinfo
  45 database (the set of files describing time zones)\&. Examples of such systems are Linux, FreeBSD, Solaris, and Mac OS X\&. One likely location for these files is the
  46 /usr/share/zoneinfo
  47 directory (/usr/share/lib/zoneinfo
  48 on Solaris)\&. If your system does not have a zoneinfo database, you can use the downloadable package described in
  49 Section\ \&10.6, \(lqMySQL Server Time Zone Support\(rq\&.
  50 .PP
  51 \fBmysql_tzinfo_to_sql\fR
  52 can be invoked several ways:
  53 .sp
  54 .if n \{\
  55 .RS 4
  56 .\}
  57 .nf
  58 shell> \fBmysql_tzinfo_to_sql \fR\fB\fItz_dir\fR\fR
  59 shell> \fBmysql_tzinfo_to_sql \fR\fB\fItz_file tz_name\fR\fR
  60 shell> \fBmysql_tzinfo_to_sql \-\-leap \fR\fB\fItz_file\fR\fR
  61 .fi
  62 .if n \{\
  63 .RE
  64 .\}
  65 .PP
  66 For the first invocation syntax, pass the zoneinfo directory path name to
  67 \fBmysql_tzinfo_to_sql\fR
  68 and send the output into the
  69 \fBmysql\fR
  70 program\&. For example:
  71 .sp
  72 .if n \{\
  73 .RS 4
  74 .\}
  75 .nf
  76 shell> \fBmysql_tzinfo_to_sql /usr/share/zoneinfo | mysql \-u root mysql\fR
  77 .fi
  78 .if n \{\
  79 .RE
  80 .\}
  81 .PP
  82 \fBmysql_tzinfo_to_sql\fR
  83 reads your system\*(Aqs time zone files and generates SQL statements from them\&.
  84 \fBmysql\fR
  85 processes those statements to load the time zone tables\&.
  86 .PP
  87 The second syntax causes
  88 \fBmysql_tzinfo_to_sql\fR
  89 to load a single time zone file
  90 \fItz_file\fR
  91 that corresponds to a time zone name
  92 \fItz_name\fR:
  93 .sp
  94 .if n \{\
  95 .RS 4
  96 .\}
  97 .nf
  98 shell> \fBmysql_tzinfo_to_sql \fR\fB\fItz_file\fR\fR\fB \fR\fB\fItz_name\fR\fR\fB | mysql \-u root mysql\fR
  99 .fi
 100 .if n \{\
 101 .RE
 102 .\}
 103 .PP
 104 If your time zone needs to account for leap seconds, invoke
 105 \fBmysql_tzinfo_to_sql\fR
 106 using the third syntax, which initializes the leap second information\&.
 107 \fItz_file\fR
 108 is the name of your time zone file:
 109 .sp
 110 .if n \{\
 111 .RS 4
 112 .\}
 113 .nf
 114 shell> \fBmysql_tzinfo_to_sql \-\-leap \fR\fB\fItz_file\fR\fR\fB | mysql \-u root mysql\fR
 115 .fi
 116 .if n \{\
 117 .RE
 118 .\}
 119 .PP
 120 After running
 121 \fBmysql_tzinfo_to_sql\fR, it is best to restart the server so that it does not continue to use any previously cached time zone data\&.
 122 .SH "COPYRIGHT"
 123 .br
 124 .PP
 125 Copyright \(co 1997, 2013, Oracle and/or its affiliates. All rights reserved.
 126 .PP
 127 This documentation is free software; you can redistribute it and/or modify it only under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.
 128 .PP
 129 This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
 130 .PP
 131 You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or see http://www.gnu.org/licenses/.
 132 .sp
 133 .SH "SEE ALSO"
 134 For more information, please refer to the MySQL Reference Manual,
 135 which may already be installed locally and which is also available
 136 online at http://dev.mysql.com/doc/.
 137 .SH AUTHOR
 138 Oracle Corporation (http://dev.mysql.com/).