xref: /freebsd/tools/test/ppsapi/README (revision d0b2dbfa0ecf2bbc9709efc5e20baf8e4b44bbbf)
13d9368b2SPoul-Henning Kamp
23d9368b2SPoul-Henning KampThis is a small test program which I have had around since we wrote
33d9368b2SPoul-Henning Kampthe RFC 2783 API.
43d9368b2SPoul-Henning Kamp
53d9368b2SPoul-Henning KampOptions:
63d9368b2SPoul-Henning Kamp	-a 	capture assert flank
73d9368b2SPoul-Henning Kamp	-c	capture clear flank
83d9368b2SPoul-Henning Kamp	(if neither -a -c: capture all available flanks)
93d9368b2SPoul-Henning Kamp	-A	output on assert flank
103d9368b2SPoul-Henning Kamp	-C	output on clear flank
113d9368b2SPoul-Henning Kamp	(if neither -A -C: output on all flanks)
123d9368b2SPoul-Henning Kamp	-e	enable echo (all possible flanks)
133d9368b2SPoul-Henning Kamp	-u	unbuffered output.
143d9368b2SPoul-Henning Kamp	-v	verbose.
153d9368b2SPoul-Henning Kamp
163d9368b2SPoul-Henning KampThe output looks like:
173d9368b2SPoul-Henning Kamp
18*839f11a4SEitan Adler# ./ppsapitest -C /dev/cuau4
193d9368b2SPoul-Henning Kamp1070915603 .703680117 119 1070915940 .902275676 121
203d9368b2SPoul-Henning Kamp1070915941 .703657317 120 1070915941 .902327516 122
213d9368b2SPoul-Henning Kamp1070915942 .703657077 121 1070915942 .902367957 123
223d9368b2SPoul-Henning Kamp1070915943 .703657557 122 1070915943 .902419077 124
233d9368b2SPoul-Henning Kamp1070915944 .703656717 123 1070915944 .902467197 125
243d9368b2SPoul-Henning Kamp1070915945 .703657077 124 1070915945 .902527078 126
253d9368b2SPoul-Henning Kamp
263d9368b2SPoul-Henning KampColumns:
273d9368b2SPoul-Henning Kamp
283d9368b2SPoul-Henning Kamp	assert seconds (tv_sec)
293d9368b2SPoul-Henning Kamp	assert nanoseconds (tv_nsec)
303d9368b2SPoul-Henning Kamp	assert sequence number
313d9368b2SPoul-Henning Kamp	clear seconds (tv_sec)
323d9368b2SPoul-Henning Kamp	clear nanoseconds (tv_nsec)
333d9368b2SPoul-Henning Kamp	clear sequence number
343d9368b2SPoul-Henning Kamp
353d9368b2SPoul-Henning Kamp(If the -C option had not been specified, twice as many lines would
363d9368b2SPoul-Henning Kampbe output:
373d9368b2SPoul-Henning Kamp
38*839f11a4SEitan Adler# ./ppsapitest /dev/cuau4
393d9368b2SPoul-Henning Kamp1070916432 .703624557 125 1070915945 .902527078 126
403d9368b2SPoul-Henning Kamp1070916432 .703624557 125 1070916432 .902303156 127
413d9368b2SPoul-Henning Kamp1070916433 .703624557 126 1070916432 .902303156 127
423d9368b2SPoul-Henning Kamp1070916433 .703624557 126 1070916433 .902348396 128
433d9368b2SPoul-Henning Kamp1070916434 .703625757 127 1070916433 .902348396 128
443d9368b2SPoul-Henning Kamp1070916434 .703625757 127 1070916434 .902396877 129
453d9368b2SPoul-Henning Kamp1070916435 .703623837 128 1070916434 .902396877 129
463d9368b2SPoul-Henning Kamp1070916435 .703623837 128 1070916435 .902444277 130
473d9368b2SPoul-Henning Kamp
48