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