← Back to branch summary

~ubuntu-branches/ubuntu/vivid/daemontools/vivid-proposed

« back to all changes in this revision

Viewing changes to debian/daemontools-man/tai64n.8

  • Committer: Bazaar Package Importer
  • Author(s): Gerrit Pape
  • Date: 2008-04-16 21:20:38 UTC
  • Revision ID: james.westby@ubuntu.com-20080416212038-ocs1d01xja16bjvl
Tags: 1:0.76-3
http://bugs.debian.org/475619
* debian/daemontools-run.postinst: don't exec into the kill program, so
  that the shell builtin is used (closes: #475619).
* debian/daemontools-run.postrm: ignore error if 'kill -s HUP 1' fails
  for some reason on package removal (#474141).
* debian/control: Standards-Version: 3.7.3.0.

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/daemontools-man/tai64n.8
 
1
.TH tai64n 8
 
2
.SH NAME
 
3
tai64n \- puts a precise timestamp on each line.
 
4
.SH SYNOPSIS
 
5
.B tai64n
 
6
.SH DESCRIPTION
 
7
.B tai64n
 
8
reads lines from stdin. For each line, it writes 
 
9
.IP 1
 
10
an @, 
 
11
.IP 2.
 
12
a precise timestamp, 
 
13
.IP 3.
 
14
a space, and 
 
15
.IP 4.
 
16
a copy of the input line 
 
17
 
 
18
to stdout. The timestamp indicates the moment that
 
19
.B tai64n
 
20
read the first character of the line. 
 
21
 
 
22
.B tai64n
 
23
does not allocate any memory after it starts.
 
24
.SH TIMESTAMPS
 
25
Timestamps used by
 
26
.B tai64n
 
27
are 12-byte TAI64N labels in external TAI64N format, printed as 24 lowercase
 
28
hexadecimal characters. You can use
 
29
.BR tai64nlocal (8)
 
30
to convert the timestamps to a human-readable format. 
 
31
 
 
32
For example, the timestamp 4000000037c219bf2ef02e94 refers to the nanosecond
 
33
beginning exactly 935467455.787492500 seconds after the beginning of 1970 TAI;
 
34
37c219bf hexadecimal is 935467455, and 2ef02e94 hexadecimal is 787492500. 
 
35
 
 
36
The current implementation of
 
37
.B tai64n
 
38
relies on the UNIX gettimeofday library routine to return the current time as
 
39
the number of TAI seconds since 1970-01-01 00:00:10 TAI. Beware that most
 
40
gettimeofday implementations are not Y2038-compliant. Furthermore, most clocks
 
41
are not set accurately. 
 
42
.SH EXIT CODES
 
43
.B tai64n
 
44
exits 0 when it sees end of input. It exits 111 without an error message if
 
45
it has trouble reading stdin or writing stdout. 
 
46
.SH SEE ALSO
 
47
supervise(8),
 
48
svc(8),
 
49
svok(8),
 
50
svstat(8),
 
51
svscanboot(8),
 
52
svscan(8),
 
53
readproctitle(8),
 
54
fghack(8),  
 
55
pgrphack(8),
 
56
multilog(8),
 
57
tai64nlocal(8),
 
58
setuidgid(8),
 
59
envuidgid(8),
 
60
envdir(8),
 
61
softlimit(8),
 
62
setlock(8)
 
63
 
 
64
http://cr.yp.to/daemontools.html