.H 1 warp

.B warp

executes a dynamically linked command in a different time frame.

It intercepts time related system calls and modifies the times seen by

the command using the formula:

.EX

time' = time + warp + (time - base) * (factor - 1)

.EE

where:

.BL

.LI

.I time'

The logical system time seen by the command process.

.LI

.I time

The physical system time.

.LI

.I warp

A fixed offset from the physical system time

(i.e., the warp.)

.LI

.I base

The physical system time when

.B warp

was first applied to the process or any ancestor process.

.LI

.I factor

The rate of logical time change with respect to the physical clock

(i.e., the warp factor.)

.LE

.IR warp ,

.IR base ,

and

.I factor

are inherited by children of warped processes so that a child process

is warped in the same time frame as its parent.

Time progresses for warped processes at the rate of

.I factor

times the physical system clock.

Any files created by a warped process

will appear to be in the warped logical time frame

for that process but will appear in physical system time frame

for non-warped processes.

.P

Statically-linked, set-uid or set-gid commands are not warped.

.H 2 Interface

.B warp

[

.B \-b

.I base

] [

.B \-f

.I factor

] [

.B \-n

] [

.B \-t

]

.I date

[

.I command

[

.I arg

\&...

] ]

.P

The components of the warp formula are set as follows:

the warp offset

.I warp

is

.IR date-now ,

.I base

is

.I date

by default,

and

.I factor

is 1 by default.

.P

Command argument date specifications support common conventions:

.EX

yesterday

next week

50 days

2000-02-28/00:00

feb 28 2000

.EE

Absolute seconds since the epoch, a.k.a.

.B time_t

values, are represented by

.BI # seconds.

.P

The

.B \-n

option shows how

.I command

would be executed without actually executing it.

The

.B \-t

option traces each intercepted system call.

.P

.B warp

executes

.I command

with optional

.IR args ,

or

.B $SHELL

if

.I command

is omitted.

.H 2 Examples

.EX

$ date -f %Y-%m-%d/%H:%M

1998-03-11/13:41

$ warp 2000-02-29/12:30:30 date -f %Y-%m-%d/%H:%M

2000-02-29/12:30

$ date -f %Y-%m-%d/%H:%M

1998-03-11/13:44

$ warp +57060970 date

2000-01-01/00:00

# get a shell where 1 logical day passes for each physical second

$ PS1='(warp) ' warp -f $(60*60*24) 2000-02-29/12:30:30

(warp) date -f %Y-%m-%d/%H:%M

2000-03-07/18:58

(warp) sleep 1

(warp) date -f %Y-%m-%d/%H:%M

2000-03-19/18:58

.EE