The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/sys/timepps.h

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 /*      $NetBSD: timepps.h,v 1.18 2008/04/21 12:56:31 ad Exp $  */
    2 
    3 /*
    4  * Copyright (c) 1998 Jonathan Stone
    5  * All rights reserved.
    6  *
    7  * Redistribution and use in source and binary forms, with or without
    8  * modification, are permitted provided that the following conditions
    9  * are met:
   10  * 1. Redistributions of source code must retain the above copyright
   11  *    notice, this list of conditions and the following disclaimer.
   12  * 2. Redistributions in binary form must reproduce the above copyright
   13  *    notice, this list of conditions and the following disclaimer in the
   14  *    documentation and/or other materials provided with the distribution.
   15  * 3. All advertising materials mentioning features or use of this software
   16  *    must display the following acknowledgement:
   17  *      This product includes software developed by Jonathan Stone for
   18  *      the NetBSD Project.
   19  * 4. The name of the author may not be used to endorse or promote products
   20  *    derived from this software without specific prior written permission.
   21  *
   22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
   23  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   24  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
   25  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
   26  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
   27  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
   28  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
   29  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
   30  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
   31  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   32  */
   33 
   34 #ifndef _SYS_TIMEPPS_H_
   35 #define _SYS_TIMEPPS_H_
   36 
   37 /*
   38  * This header file complies with "Pulse-Per-Second API for UNIX-like
   39  * Operating Systems, Version 1.0", draft-mogul-pps-api-05.txt
   40  */
   41 
   42 #include <sys/ioccom.h>
   43 
   44 #define PPS_API_VERS_1  1       /* API version number */
   45 
   46 /*
   47  * PPSAPI type definitions
   48  */
   49 typedef int32_t pps_handle_t;   /* represents a PPS source */
   50 typedef uint32_t pps_seq_t;     /* sequence number, at least 32 bits */
   51 
   52 typedef union pps_timeu {
   53         struct timespec tspec;
   54         struct {        /* NTP long fixed-point format */
   55                 unsigned int     integral;
   56                 unsigned int     fractional;
   57         } ntplfp;
   58         unsigned long   longpair[2];
   59 } pps_timeu_t;
   60 
   61 
   62 /*
   63  * timestamp information
   64  */
   65 typedef struct {
   66         pps_seq_t       assert_sequence;        /* assert event seq # */
   67         pps_seq_t       clear_sequence;         /* clear event seq # */
   68         pps_timeu_t     assert_tu;
   69         pps_timeu_t     clear_tu;
   70         int             current_mode;           /* current mode bits */
   71 } pps_info_t;
   72 
   73 #define assert_timestamp        assert_tu.tspec
   74 #define clear_timestamp         clear_tu.tspec
   75 
   76 
   77 /*
   78  * Parameter structure
   79  */
   80 typedef struct {
   81         int api_version;                        /* API version number */
   82         int mode;                               /* mode bits */
   83         pps_timeu_t     assert_off_tu;
   84         pps_timeu_t     clear_off_tu;
   85 } pps_params_t;
   86 #define assert_offset           assert_off_tu.tspec
   87 #define clear_offset            clear_off_tu.tspec
   88 
   89 
   90 /*
   91  * Device/implementation parameters (mode, edge bits)
   92  */
   93 #define PPS_CAPTUREASSERT       0x01
   94 #define PPS_CAPTURECLEAR        0x02
   95 #define PPS_CAPTUREBOTH         0x03
   96 #define PPS_OFFSETASSERT        0x10
   97 #define PPS_OFFSETCLEAR         0x20
   98 #define PPS_CANWAIT             0x100
   99 #define PPS_CANPOLL             0x200
  100 
  101 /*
  102  * Kernel actions
  103  */
  104 #define PPS_ECHOASSERT          0x40
  105 #define PPS_ECHOCLEAR           0x80
  106 
  107 
  108 /*
  109  * timestamp formats (tsformat, mode)
  110  */
  111 #define PPS_TSFMT_TSPEC         0x1000
  112 #define PPS_TSFMT_NTPLFP        0x2000
  113 
  114 /*
  115  * Kernel discipline actions (kernel_consumer)
  116  */
  117 #define PPS_KC_HARDPPS          0
  118 #define PPS_KC_HARDPPS_PLL      1
  119 #define PPS_KC_HARDPPS_FLL      2
  120 
  121 /*
  122  * IOCTL definitions
  123  */
  124 #define PPS_IOC_CREATE          _IO('1', 1)
  125 #define PPS_IOC_DESTROY         _IO('1', 2)
  126 #define PPS_IOC_SETPARAMS       _IOW('1', 3, pps_params_t)
  127 #define PPS_IOC_GETPARAMS       _IOR('1', 4, pps_params_t)
  128 #define PPS_IOC_GETCAP          _IOR('1', 5, int)
  129 #define PPS_IOC_FETCH           _IOWR('1', 6, pps_info_t)
  130 #define PPS_IOC_KCBIND          _IOW('1', 7, int)
  131 
  132 #ifdef _KERNEL
  133 
  134 #include <sys/mutex.h>
  135 
  136 extern kmutex_t timecounter_lock;
  137 
  138 struct pps_state {
  139         /* Capture information. */
  140         struct timehands *capth;
  141         unsigned        capgen;
  142         unsigned        capcount;
  143 
  144         /* State information. */
  145         pps_params_t    ppsparam;
  146         pps_info_t      ppsinfo;
  147         int             kcmode;
  148         int             ppscap;
  149         struct timecounter *ppstc;
  150         unsigned        ppscount[3];
  151 };
  152 
  153 void pps_capture(struct pps_state *);
  154 void pps_event(struct pps_state *, int);
  155 void pps_init(struct pps_state *);
  156 int pps_ioctl(unsigned long, void *, struct pps_state *);
  157 
  158 #else /* !_KERNEL */
  159 
  160 #include <sys/cdefs.h>
  161 #include <sys/ioctl.h>
  162 #include <errno.h>
  163 
  164 static __inline int time_pps_create(int, pps_handle_t *);
  165 static __inline int time_pps_destroy(pps_handle_t);
  166 static __inline int time_pps_setparams(pps_handle_t, const pps_params_t *);
  167 static __inline int time_pps_getparams(pps_handle_t, pps_params_t *);
  168 static __inline int time_pps_getcap(pps_handle_t, int *);
  169 static __inline int time_pps_fetch(pps_handle_t, const int, pps_info_t *,
  170         const struct timespec *);
  171 #if 0
  172 static __inline int time_pps_wait(pps_handle_t, const struct timespec *,
  173         pps_info_t *);
  174 #endif
  175 
  176 static __inline int time_pps_kcbind(pps_handle_t, const int, const int,
  177         const int);
  178 
  179 static __inline int
  180 time_pps_create(filedes, handle)
  181         int filedes;
  182         pps_handle_t *handle;
  183 {
  184 
  185         *handle = filedes;
  186         return (0);
  187 }
  188 
  189 static __inline int
  190 time_pps_destroy(handle)
  191         pps_handle_t handle;
  192 {
  193 
  194         return (0);
  195 }
  196 
  197 static __inline int
  198 time_pps_setparams(handle, ppsparams)
  199         pps_handle_t handle;
  200         const pps_params_t *ppsparams;
  201 {
  202 
  203         return (ioctl(handle, PPS_IOC_SETPARAMS, __UNCONST(ppsparams)));
  204 }
  205 
  206 static __inline int
  207 time_pps_getparams(handle, ppsparams)
  208         pps_handle_t handle;
  209         pps_params_t *ppsparams;
  210 {
  211 
  212         return (ioctl(handle, PPS_IOC_GETPARAMS, ppsparams));
  213 }
  214 
  215 static __inline int
  216 time_pps_getcap(handle, mode)
  217         pps_handle_t handle;
  218         int *mode;
  219 {
  220 
  221         return (ioctl(handle, PPS_IOC_GETCAP, mode));
  222 }
  223 
  224 static __inline int
  225 time_pps_fetch(handle, tsformat, ppsinfobuf, timeout)
  226         pps_handle_t handle;
  227         const int tsformat;
  228         pps_info_t *ppsinfobuf;
  229         const struct timespec *timeout;
  230 {
  231 
  232         return (ioctl(handle, PPS_IOC_FETCH, ppsinfobuf));
  233 }
  234 
  235 static __inline int
  236 time_pps_kcbind(handle, kernel_consumer, edge, tsformat)
  237         pps_handle_t handle;
  238         const int kernel_consumer;
  239         const int edge;
  240         const int tsformat;
  241 {
  242 
  243         if (tsformat != PPS_TSFMT_TSPEC) {
  244                 errno = EINVAL;
  245                 return -1;
  246         }
  247 
  248         return (ioctl(handle, PPS_IOC_KCBIND, __UNCONST(&edge)));
  249 }
  250 #endif /* !_KERNEL*/
  251 #endif /* SYS_TIMEPPS_H_ */

Cache object: 30261da34d1ac76d9d5bdc025fd9b2db


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.