                           Time Machine

               Copyright(c) 1999,2003 Jiro SEKIBA <jir@hello.to>


* What's Time Machine

 This program hooks time(2), gettimeofday(2) and clock_gettime(3), then
run another program under the user specified time system.
So if you start a program at 00:00:00 1st Jan 1900 then, 
after 1 hour later the program's time system will be 01:00:00 1st Jan 1900.

* Install

$ tar zxvf timemachine.tar.gz
$ cd timemachine-<version>
$ ./configure
$ make
$ su
# make install
# ldconfig -v

see INSTALL document for further information 

* Usage

 There are 3 ways to run this program.  Specify date to run, Specify
seconds since 1st Jan 1900 to run and Specify seconds since now to run.
Program options are like below.

Usage: timemachine [-y year][-m month][-d day][-H hour][-M minutes]
                   [-S seconds] -p program [args...]
Usage: timemachine [-s +/- seconds] -p program [args...]
Usage: timemachine [-u s seconds since 1st Jan 1900] -p program [args...]

options   arguments            description
  -y       year            specify trip year(>1900)
  -m       month           specify trip month(1-12)
  -d       day             specify trip day(1-31)
  -H       hour            specify trip hour(0-23)
  -M       minutes         specify trip minutes(0-59)
  -S       seconds         specify trip seconds(0-59)
  -u       +seconds        specify trip seconds since 1st Jan 1900
  -s       +/-seconds      specify trip seconds since now
                           if minus, means past

* Exapmle

$ date
Sat Nov  6 23:07:43 JST 1999
$ timemachine -y 1973 -p date
Tue Nov  6 23:07:44 JST 1973

$ timemachine -u 10 -p date
Thu Jan  1 09:00:10 JST 1970

$ date
Sat Nov  6 23:09:17 JST 1999
$ timemachine -s 60 -p date
Sat Nov  6 23:10:18 JST 1999

$ timemachine -y 1988 -p bash
$ date
Sun Nov  6 23:09:52 JST 1988
======30 minutes later======
$ date
Sun Nov  6 23:39:52 JST 1988

* Copyright

 This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is 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.

* Author

  Jiro SEKIBA <jir@hello.to>
