1 /* $NetBSD: parse.h,v 1.5 2016/01/08 21:35:35 christos Exp $ */ 2 3 /* 4 * /src/NTP/REPOSITORY/ntp4-dev/include/parse.h,v 4.12 2007/01/14 08:36:03 kardel RELEASE_20070114_A 5 * 6 * parse.h,v 4.12 2007/01/14 08:36:03 kardel RELEASE_20070114_A 7 * 8 * Copyright (c) 1995-2015 by Frank Kardel <kardel <AT> ntp.org> 9 * Copyright (c) 1989-1994 by Frank Kardel, Friedrich-Alexander Universitaet Erlangen-Nuernberg, Germany 10 * 11 * Redistribution and use in source and binary forms, with or without 12 * modification, are permitted provided that the following conditions 13 * are met: 14 * 1. Redistributions of source code must retain the above copyright 15 * notice, this list of conditions and the following disclaimer. 16 * 2. Redistributions in binary form must reproduce the above copyright 17 * notice, this list of conditions and the following disclaimer in the 18 * documentation and/or other materials provided with the distribution. 19 * 3. Neither the name of the author nor the names of its contributors 20 * may be used to endorse or promote products derived from this software 21 * without specific prior written permission. 22 * 23 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 26 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33 * SUCH DAMAGE. 34 * 35 */ 36 37 #ifndef __PARSE_H__ 38 #define __PARSE_H__ 39 #if !(defined(lint) || defined(__GNUC__)) 40 static char parsehrcsid[]="parse.h,v 4.12 2007/01/14 08:36:03 kardel RELEASE_20070114_A"; 41 #endif 42 43 #include "ntp_types.h" 44 45 #include "parse_conf.h" 46 47 /* 48 * we use the following datastructures in two modes 49 * either in the NTP itself where we use NTP time stamps at some places 50 * or in the kernel, where only struct timeval will be used. 51 */ 52 #undef PARSEKERNEL 53 #if defined(KERNEL) || defined(_KERNEL) 54 #ifndef PARSESTREAM 55 #define PARSESTREAM 56 #endif 57 #endif 58 #if defined(PARSESTREAM) && defined(HAVE_SYS_STREAM_H) 59 #define PARSEKERNEL 60 #endif 61 #ifdef PARSEKERNEL 62 #ifndef _KERNEL 63 extern caddr_t kmem_alloc (unsigned int); 64 extern caddr_t kmem_free (caddr_t, unsigned int); 65 extern unsigned int splx (unsigned int); 66 extern unsigned int splhigh (void); 67 extern unsigned int splclock (void); 68 #define MALLOC(_X_) (char *)kmem_alloc(_X_) 69 #define FREE(_X_, _Y_) kmem_free((caddr_t)_X_, _Y_) 70 #else 71 #include <sys/kmem.h> 72 #define MALLOC(_X_) (char *)kmem_alloc(_X_, KM_SLEEP) 73 #define FREE(_X_, _Y_) kmem_free((caddr_t)_X_, _Y_) 74 #endif 75 #else 76 #define MALLOC(_X_) malloc(_X_) 77 #define FREE(_X_, _Y_) free(_X_) 78 #endif 79 80 #if defined(PARSESTREAM) && defined(HAVE_SYS_STREAM_H) 81 #include <sys/stream.h> 82 #include <sys/stropts.h> 83 #else /* STREAM */ 84 #include <stdio.h> 85 #include "ntp_syslog.h" 86 #ifdef DEBUG 87 #define DD_PARSE 5 88 #define DD_RAWDCF 4 89 #define parseprintf(LEVEL, ARGS) if (debug > LEVEL) printf ARGS 90 #else /* DEBUG */ 91 #define parseprintf(LEVEL, ARGS) 92 #endif /* DEBUG */ 93 #endif /* PARSESTREAM */ 94 95 #if defined(timercmp) && defined(__GNUC__) 96 #undef timercmp 97 #endif 98 99 #if !defined(timercmp) 100 #define timercmp(tvp, uvp, cmp) \ 101 ((tvp)->tv_sec cmp (uvp)->tv_sec || \ 102 ((tvp)->tv_sec == (uvp)->tv_sec && (tvp)->tv_usec cmp (uvp)->tv_usec)) 103 #endif 104 105 #ifndef TIMES10 106 #define TIMES10(_X_) (((_X_) << 3) + ((_X_) << 1)) 107 #endif 108 109 /* 110 * some constants useful for GPS time conversion 111 */ 112 #define GPSORIGIN 2524953600UL /* NTP origin - GPS origin in seconds */ 113 #define GPSWRAP 990U /* assume week count less than this in the previous epoch */ 114 #define GPSWEEKS 1024U /* number of weeks until the GPS epch rolls over */ 115 116 /* 117 * state flags 118 */ 119 #define PARSEB_POWERUP 0x00000001 /* no synchronisation */ 120 #define PARSEB_NOSYNC 0x00000002 /* timecode currently not confirmed */ 121 122 /* 123 * time zone information 124 */ 125 #define PARSEB_ANNOUNCE 0x00000010 /* switch time zone warning (DST switch) */ 126 #define PARSEB_DST 0x00000020 /* DST in effect */ 127 #define PARSEB_UTC 0x00000040 /* UTC time */ 128 129 /* 130 * leap information 131 */ 132 #define PARSEB_LEAPDEL 0x00000100 /* LEAP deletion warning */ 133 #define PARSEB_LEAPADD 0x00000200 /* LEAP addition warning */ 134 #define PARSEB_LEAPS 0x00000300 /* LEAP warnings */ 135 #define PARSEB_LEAPSECOND 0x00000400 /* actual leap second */ 136 /* 137 * optional status information 138 */ 139 #define PARSEB_CALLBIT 0x00001000 /* "call bit" used to signalize irregularities in the control facilities */ 140 #define PARSEB_POSITION 0x00002000 /* position available */ 141 #define PARSEB_MESSAGE 0x00004000 /* addtitional message data */ 142 /* 143 * feature information 144 */ 145 #define PARSEB_S_LEAP 0x00010000 /* supports LEAP */ 146 #define PARSEB_S_CALLBIT 0x00020000 /* supports callbit information */ 147 #define PARSEB_S_PPS 0x00040000 /* supports PPS time stamping */ 148 #define PARSEB_S_POSITION 0x00080000 /* supports position information (GPS) */ 149 150 /* 151 * time stamp availability 152 */ 153 #define PARSEB_TIMECODE 0x10000000 /* valid time code sample */ 154 #define PARSEB_PPS 0x20000000 /* valid PPS sample */ 155 156 #define PARSE_TCINFO (PARSEB_ANNOUNCE|PARSEB_POWERUP|PARSEB_NOSYNC|PARSEB_DST|\ 157 PARSEB_UTC|PARSEB_LEAPS|PARSEB_CALLBIT|PARSEB_S_LEAP|\ 158 PARSEB_S_LOCATION|PARSEB_TIMECODE|PARSEB_MESSAGE) 159 160 #define PARSE_POWERUP(x) ((x) & PARSEB_POWERUP) 161 #define PARSE_NOSYNC(x) (((x) & (PARSEB_POWERUP|PARSEB_NOSYNC)) == PARSEB_NOSYNC) 162 #define PARSE_SYNC(x) (((x) & (PARSEB_POWERUP|PARSEB_NOSYNC)) == 0) 163 #define PARSE_ANNOUNCE(x) ((x) & PARSEB_ANNOUNCE) 164 #define PARSE_DST(x) ((x) & PARSEB_DST) 165 #define PARSE_UTC(x) ((x) & PARSEB_UTC) 166 #define PARSE_LEAPADD(x) (PARSE_SYNC(x) && (((x) & PARSEB_LEAPS) == PARSEB_LEAPADD)) 167 #define PARSE_LEAPDEL(x) (PARSE_SYNC(x) && (((x) & PARSEB_LEAPS) == PARSEB_LEAPDEL)) 168 #define PARSE_CALLBIT(x) ((x) & PARSEB_CALLBIT) 169 #define PARSE_LEAPSECOND(x) (PARSE_SYNC(x) && ((x) & PARSEB_LEAP_SECOND)) 170 171 #define PARSE_S_LEAP(x) ((x) & PARSEB_S_LEAP) 172 #define PARSE_S_CALLBIT(x) ((x) & PARSEB_S_CALLBIT) 173 #define PARSE_S_PPS(x) ((x) & PARSEB_S_PPS) 174 #define PARSE_S_POSITION(x) ((x) & PARSEB_S_POSITION) 175 176 #define PARSE_TIMECODE(x) ((x) & PARSEB_TIMECODE) 177 #define PARSE_PPS(x) ((x) & PARSEB_PPS) 178 #define PARSE_POSITION(x) ((x) & PARSEB_POSITION) 179 #define PARSE_MESSAGE(x) ((x) & PARSEB_MESSAGE) 180 181 /* 182 * operation flags - lower nibble contains fudge flags 183 */ 184 #define PARSE_TRUSTTIME CLK_FLAG1 /* use flag1 to indicate the time2 references mean the trust time */ 185 #define PARSE_CLEAR CLK_FLAG2 /* use flag2 to control pps on assert */ 186 #define PARSE_PPSKERNEL CLK_FLAG3 /* use flag3 to bind PPS to kernel */ 187 #define PARSE_LEAP_DELETE CLK_FLAG4 /* use flag4 to force leap deletion - only necessary when earth slows down */ 188 189 #define PARSE_FIXED_FMT 0x10 /* fixed format */ 190 #define PARSE_PPSCLOCK 0x20 /* try to get PPS time stamp via ppsclock ioctl */ 191 192 /* 193 * size of buffers 194 */ 195 #define PARSE_TCMAX 400 /* maximum addition data size */ 196 197 typedef union 198 { 199 struct timeval tv; /* timeval - kernel view */ 200 l_fp fp; /* fixed point - ntp view */ 201 } timestamp_t; 202 203 /* 204 * standard time stamp structure 205 */ 206 struct parsetime 207 { 208 u_long parse_status; /* data status - CVT_OK, CVT_NONE, CVT_FAIL ... */ 209 timestamp_t parse_time; /* PARSE timestamp */ 210 timestamp_t parse_stime; /* telegram sample timestamp */ 211 timestamp_t parse_ptime; /* PPS time stamp */ 212 long parse_usecerror; /* sampled usec error */ 213 u_long parse_state; /* current receiver state */ 214 unsigned short parse_format; /* format code */ 215 unsigned short parse_msglen; /* length of message */ 216 unsigned char parse_msg[PARSE_TCMAX]; /* original messages */ 217 }; 218 219 typedef struct parsetime parsetime_t; 220 221 /*---------- STREAMS interface ----------*/ 222 223 #ifdef HAVE_SYS_STREAM_H 224 /* 225 * ioctls 226 */ 227 #define PARSEIOC_ENABLE (('D'<<8) + 'E') 228 #define PARSEIOC_DISABLE (('D'<<8) + 'D') 229 #define PARSEIOC_SETFMT (('D'<<8) + 'f') 230 #define PARSEIOC_GETFMT (('D'<<8) + 'F') 231 #define PARSEIOC_SETCS (('D'<<8) + 'C') 232 #define PARSEIOC_TIMECODE (('D'<<8) + 'T') 233 234 #endif 235 236 /*------ IO handling flags (sorry) ------*/ 237 238 #define PARSE_IO_CSIZE 0x00000003 239 #define PARSE_IO_CS5 0x00000000 240 #define PARSE_IO_CS6 0x00000001 241 #define PARSE_IO_CS7 0x00000002 242 #define PARSE_IO_CS8 0x00000003 243 244 /* 245 * ioctl structure 246 */ 247 union parsectl 248 { 249 struct parsegettc 250 { 251 u_long parse_state; /* last state */ 252 u_long parse_badformat; /* number of bad packets since last query */ 253 unsigned short parse_format;/* last decoded format */ 254 unsigned short parse_count; /* count of valid time code bytes */ 255 char parse_buffer[PARSE_TCMAX+1]; /* timecode buffer */ 256 } parsegettc; 257 258 struct parseformat 259 { 260 unsigned short parse_format;/* number of examined format */ 261 unsigned short parse_count; /* count of valid string bytes */ 262 char parse_buffer[PARSE_TCMAX+1]; /* format code string */ 263 } parseformat; 264 265 struct parsesetcs 266 { 267 u_long parse_cs; /* character size (needed for stripping) */ 268 } parsesetcs; 269 }; 270 271 typedef union parsectl parsectl_t; 272 273 /*------ for conversion routines --------*/ 274 275 struct parse /* parse module local data */ 276 { 277 int parse_flags; /* operation and current status flags */ 278 279 int parse_ioflags; /* io handling flags (5-8 Bit control currently) */ 280 281 /* 282 * private data - fixed format only 283 */ 284 unsigned short parse_plen; /* length of private data */ 285 void *parse_pdata; /* private data pointer */ 286 287 /* 288 * time code input buffer (from RS232 or PPS) 289 */ 290 unsigned short parse_index; /* current buffer index */ 291 char *parse_data; /* data buffer */ 292 unsigned short parse_dsize; /* size of data buffer */ 293 unsigned short parse_lformat; /* last format used */ 294 u_long parse_lstate; /* last state code */ 295 char *parse_ldata; /* last data buffer */ 296 unsigned short parse_ldsize; /* last data buffer length */ 297 u_long parse_badformat; /* number of unparsable pakets */ 298 299 timestamp_t parse_lastchar; /* last time a character was received */ 300 parsetime_t parse_dtime; /* external data prototype */ 301 }; 302 303 typedef struct parse parse_t; 304 305 struct clocktime /* clock time broken up from time code */ 306 { 307 long day; 308 long month; 309 long year; 310 long hour; 311 long minute; 312 long second; 313 long usecond; 314 long utcoffset; /* in seconds */ 315 time_t utctime; /* the actual time - alternative to date/time */ 316 u_long flags; /* current clock status */ 317 }; 318 319 typedef struct clocktime clocktime_t; 320 321 /* 322 * parser related return/error codes 323 */ 324 #define CVT_MASK (unsigned)0x0000000F /* conversion exit code */ 325 #define CVT_NONE (unsigned)0x00000001 /* format not applicable */ 326 #define CVT_FAIL (unsigned)0x00000002 /* conversion failed - error code returned */ 327 #define CVT_OK (unsigned)0x00000004 /* conversion succeeded */ 328 #define CVT_SKIP (unsigned)0x00000008 /* conversion succeeded */ 329 #define CVT_ADDITIONAL (unsigned)0x00000010 /* additional data is available */ 330 #define CVT_BADFMT (unsigned)0x00000100 /* general format error - (unparsable) */ 331 #define CVT_BADDATE (unsigned)0x00000200 /* date field incorrect */ 332 #define CVT_BADTIME (unsigned)0x00000400 /* time field incorrect */ 333 334 /* 335 * return codes used by special input parsers 336 */ 337 #define PARSE_INP_SKIP 0x00 /* discard data - may have been consumed */ 338 #define PARSE_INP_TIME 0x01 /* time code assembled */ 339 #define PARSE_INP_PARSE 0x02 /* parse data using normal algorithm */ 340 #define PARSE_INP_DATA 0x04 /* additional data to pass up */ 341 #define PARSE_INP_SYNTH 0x08 /* just pass up synthesized time */ 342 343 /* 344 * PPS edge info 345 */ 346 #define SYNC_ZERO 0x00 347 #define SYNC_ONE 0x01 348 349 typedef u_long parse_inp_fnc_t(parse_t *, char, timestamp_t *); 350 typedef u_long parse_cvt_fnc_t(unsigned char *, int, struct format *, clocktime_t *, void *); 351 typedef u_long parse_pps_fnc_t(parse_t *, int, timestamp_t *); 352 353 struct clockformat 354 { 355 /* special input protocol - implies fixed format */ 356 parse_inp_fnc_t *input; 357 /* conversion routine */ 358 parse_cvt_fnc_t *convert; 359 /* routine for handling RS232 sync events (time stamps) */ 360 /* PPS input routine */ 361 parse_pps_fnc_t *syncpps; 362 /* time code synthesizer */ 363 364 void *data; /* local parameters */ 365 const char *name; /* clock format name */ 366 unsigned short length; /* maximum length of data packet */ 367 unsigned short plen; /* length of private data - implies fixed format */ 368 }; 369 370 typedef struct clockformat clockformat_t; 371 372 /* 373 * parse interface 374 */ 375 extern int parse_ioinit (parse_t *); 376 extern void parse_ioend (parse_t *); 377 extern int parse_ioread (parse_t *, char, timestamp_t *); 378 extern int parse_iopps (parse_t *, int, timestamp_t *); 379 extern void parse_iodone (parse_t *); 380 extern int parse_timecode (parsectl_t *, parse_t *); 381 extern int parse_getfmt (parsectl_t *, parse_t *); 382 extern int parse_setfmt (parsectl_t *, parse_t *); 383 extern int parse_setcs (parsectl_t *, parse_t *); 384 385 extern unsigned int parse_restart (parse_t *, char); 386 extern unsigned int parse_addchar (parse_t *, char); 387 extern unsigned int parse_end (parse_t *); 388 389 extern int Strok (const unsigned char *, const unsigned char *); 390 extern int Stoi (const unsigned char *, long *, int); 391 392 extern time_t parse_to_unixtime (clocktime_t *, u_long *); 393 extern u_long updatetimeinfo (parse_t *, u_long); 394 extern void syn_simple (parse_t *, timestamp_t *, struct format *, u_long); 395 extern parse_pps_fnc_t pps_simple; 396 extern parse_pps_fnc_t pps_one; 397 extern parse_pps_fnc_t pps_zero; 398 extern int parse_timedout (parse_t *, timestamp_t *, struct timeval *); 399 400 #endif 401 402 /* 403 * History: 404 * 405 * parse.h,v 406 * Revision 4.12 2007/01/14 08:36:03 kardel 407 * make timestamp union anonymous to avoid conflicts with 408 * some OSes that choose to create a nameing conflic here. 409 * 410 * Revision 4.11 2005/06/25 10:58:45 kardel 411 * add missing log keywords 412 * 413 * Revision 4.5 1998/08/09 22:23:32 kardel 414 * 4.0.73e2 adjustments 415 * 416 * Revision 4.4 1998/06/14 21:09:27 kardel 417 * Sun acc cleanup 418 * 419 * Revision 4.3 1998/06/13 11:49:25 kardel 420 * STREAM macro gone in favor of HAVE_SYS_STREAM_H 421 * 422 * Revision 4.2 1998/06/12 15:14:25 kardel 423 * fixed prototypes 424 * 425 * Revision 4.1 1998/05/24 10:07:59 kardel 426 * removed old data structure cruft (new input model) 427 * new PARSE_INP* macros for input handling 428 * removed old SYNC_* macros from old input model 429 * (struct clockformat): removed old parse functions in favor of the 430 * new input model 431 * updated prototypes 432 * 433 * form V3 3.31 - log info deleted 1998/04/11 kardel 434 */ 435