xref: /illumos-gate/usr/src/uts/common/sys/timer.h (revision 66582b606a8194f7f3ba5b3a3a6dca5b0d346361)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 
22 /*
23  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 
27 /*
28  * Copyright (c) 2015, Joyent, Inc. All rights reserved.
29  */
30 
31 #ifndef	_SYS_TIMER_H
32 #define	_SYS_TIMER_H
33 
34 #include <sys/types.h>
35 #include <sys/proc.h>
36 #include <sys/thread.h>
37 
38 #ifdef	__cplusplus
39 extern "C" {
40 #endif
41 
42 #ifdef	_KERNEL
43 
44 #define	_TIMER_MAX	32
45 extern	int	timer_max;		/* patchable via /etc/system */
46 
47 /*
48  * Bit values for the it_lock field.
49  */
50 #define	ITLK_LOCKED		0x01
51 #define	ITLK_WANTED		0x02
52 #define	ITLK_REMOVE		0x04
53 
54 /*
55  * Bit values for the it_flags field.
56  */
57 #define	IT_SIGNAL		0x01
58 #define	IT_PORT			0x02	/* use event port notification */
59 
60 struct clock_backend;
61 
62 struct itimer;
63 typedef struct itimer itimer_t;
64 
65 struct itimer {
66 	itimerspec_t	it_itime;
67 	hrtime_t	it_hrtime;
68 	ushort_t	it_flags;
69 	ushort_t	it_lock;
70 	void		*it_arg;	/* clock backend-specific data */
71 	struct proc	*it_proc;
72 	union {
73 		struct {
74 			sigqueue_t	*__it_sigq;
75 			klwp_t		*__it_lwp;
76 		} __proc;
77 		void *__it_frontend;
78 	} __data;			/* timer frontend-specific data */
79 	kcondvar_t	it_cv;
80 	int		it_blockers;
81 	int		it_pending;
82 	int		it_overrun;
83 	struct clock_backend *it_backend;
84 	void		(*it_fire)(itimer_t *);
85 	kmutex_t	it_mutex;
86 	void		*it_portev;	/* port_kevent_t pointer */
87 	void		*it_portsrc;	/* port_source_t pointer */
88 	int		it_portfd;	/* port file descriptor */
89 };
90 
91 #define	it_sigq		__data.__proc.__it_sigq
92 #define	it_lwp		__data.__proc.__it_lwp
93 #define	it_frontend	__data.__it_frontend
94 
95 typedef struct clock_backend {
96 	struct sigevent clk_default;
97 	int (*clk_clock_settime)(timespec_t *);
98 	int (*clk_clock_gettime)(timespec_t *);
99 	int (*clk_clock_getres)(timespec_t *);
100 	int (*clk_timer_create)(itimer_t *, void (*)(itimer_t *));
101 	int (*clk_timer_settime)(itimer_t *, int, const struct itimerspec *);
102 	int (*clk_timer_gettime)(itimer_t *, struct itimerspec *);
103 	int (*clk_timer_delete)(itimer_t *);
104 	void (*clk_timer_lwpbind)(itimer_t *);
105 } clock_backend_t;
106 
107 extern void clock_add_backend(clockid_t clock, clock_backend_t *backend);
108 extern clock_backend_t *clock_get_backend(clockid_t clock);
109 
110 extern void timer_lwpbind();
111 
112 extern	void	timer_func(sigqueue_t *);
113 extern	void	timer_exit(void);
114 extern	void	timer_lwpexit(void);
115 extern	clock_t	hzto(struct timeval *);
116 extern	clock_t	timespectohz(timespec_t *, timespec_t);
117 extern	int64_t	timespectohz64(timespec_t *);
118 extern	int	itimerspecfix(timespec_t *);
119 extern	void	timespecadd(timespec_t *, timespec_t *);
120 extern	void	timespecsub(timespec_t *, timespec_t *);
121 extern	void	timespecfix(timespec_t *);
122 extern	int	xgetitimer(uint_t, struct itimerval *, int);
123 extern	int	xsetitimer(uint_t, struct itimerval *, int);
124 extern	void	delete_itimer_realprof(void);
125 
126 #define	timerspecisset(tvp)		((tvp)->tv_sec || (tvp)->tv_nsec)
127 #define	timerspeccmp(tvp, uvp)		(((tvp)->tv_sec - (uvp)->tv_sec) ? \
128 	((tvp)->tv_sec - (uvp)->tv_sec):((tvp)->tv_nsec - (uvp)->tv_nsec))
129 #define	timerspecclear(tvp)		((tvp)->tv_sec = (tvp)->tv_nsec = 0)
130 
131 struct oldsigevent {
132 	/* structure definition prior to notification attributes member */
133 	int		_notify;
134 	union {
135 		int		_signo;
136 		void		(*_notify_function)(union sigval);
137 	} _un;
138 	union sigval	_value;
139 };
140 
141 #if defined(_SYSCALL32)
142 
143 struct oldsigevent32 {
144 	int32_t		_notify;
145 	union {
146 		int32_t		_signo;
147 		caddr32_t	_notify_function;
148 	} _un;
149 	union sigval32	_value;
150 };
151 
152 #endif	/* _SYSCALL32 */
153 #endif	/* _KERNEL */
154 
155 #ifdef	__cplusplus
156 }
157 #endif
158 
159 #endif	/* _SYS_TIMER_H */
160