.\"	$YahooCvsId: tz2tz.1,v 1.2 2009/02/03 20:01:31 Exp $
.\"	$Source: /CVSROOT/.../tz2tz/doc/man/tz2tz.1,v $
.\"
.\"	Copyright (c) 2009 Yahoo! Inc.
.\"
.Dd February 03, 2008
.Dt TZ2TZ 1
.Os
.Sh NAME
.Nm tz2tz
.Nd timezone conversion utility
.Sh SYNOPSIS
.Nm
.Op Fl h
.\".Op Fl s Ar format
.Op Fl f Ar TZ1
.Op Fl t Ar TZ2
.Sh DESCRIPTION
The
.Nm
utility reads lines from stdin and converts timestamps found at the
beginning of the line in one timezone into timestamps in another.
The content is then printed to stdin.
This way,
.Nm
can be used to translate log files on the fly.
.Sh OPTIONS
The following options are supported by
.Nm :
.Bl -tag -width f_tz1_
.It Fl h
Print a short usage statement and exit.
.It Fl f Ar TZ1
Convert timestamps from this timezone.
If not specified, use localtime.
.It Fl t Ar TZ2
Convert timestamps to this timezone.
If not specified, use UTC.
.El
.Sh INPUT
.Nm
reads plain text lines from stdin.
The lines are expected to begin with a timestamp in the
.Xr strftime
format "%b %e %H:%M:%S", followed by any optional content.
.Pp
Any lines not following this format are ignored by
.Nm
and printed verbatim to stdout.
.Sh EXAMPLES
The following examples illustrate common usage of this tool:
.Pp
.Bd -literal -offset indent
tail -f /var/log/all | tz2tz -f UTC -t US/Pacific
.Ed
.Sh EXIT STATUS
.Ex -std 
.Sh SEE ALSO
.Xr strftime 3
.Sh HISTORY
.Nm
was originally written by
.An Jan Schaumann
.Aq jschauma@
in February 2009.
.Sh BUGS
Please file bugs and feature requests using bugzilla, Product "NSS
Architecture":
http://<bugzilla>/enter_bug.cgi?product=<product>