xref: /freebsd/tools/test/ppsapi/README (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1# $FreeBSD$
2
3This is a small test program which I have had around since we wrote
4the RFC 2783 API.
5
6Options:
7	-a 	capture assert flank
8	-c	capture clear flank
9	(if neither -a -c: capture all available flanks)
10	-A	output on assert flank
11	-C	output on clear flank
12	(if neither -A -C: output on all flanks)
13	-e	enable echo (all possible flanks)
14	-u	unbuffered output.
15	-v	verbose.
16
17The output looks like:
18
19# ./ppsapitest -C /dev/cuau4
201070915603 .703680117 119 1070915940 .902275676 121
211070915941 .703657317 120 1070915941 .902327516 122
221070915942 .703657077 121 1070915942 .902367957 123
231070915943 .703657557 122 1070915943 .902419077 124
241070915944 .703656717 123 1070915944 .902467197 125
251070915945 .703657077 124 1070915945 .902527078 126
26
27Columns:
28
29	assert seconds (tv_sec)
30	assert nanoseconds (tv_nsec)
31	assert sequence number
32	clear seconds (tv_sec)
33	clear nanoseconds (tv_nsec)
34	clear sequence number
35
36(If the -C option had not been specified, twice as many lines would
37be output:
38
39# ./ppsapitest /dev/cuau4
401070916432 .703624557 125 1070915945 .902527078 126
411070916432 .703624557 125 1070916432 .902303156 127
421070916433 .703624557 126 1070916432 .902303156 127
431070916433 .703624557 126 1070916433 .902348396 128
441070916434 .703625757 127 1070916433 .902348396 128
451070916434 .703625757 127 1070916434 .902396877 129
461070916435 .703623837 128 1070916434 .902396877 129
471070916435 .703623837 128 1070916435 .902444277 130
48
49