xref: /illumos-gate/usr/src/uts/common/sys/systm.h (revision ae115bc77f6fcde83175c75b4206dc2e50747966)
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 /*	Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T	*/
22 /*	  All Rights Reserved  	*/
23 
24 
25 /*
26  * Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
27  * Use is subject to license terms.
28  */
29 
30 #ifndef _SYS_SYSTM_H
31 #define	_SYS_SYSTM_H
32 
33 #pragma ident	"%Z%%M%	%I%	%E% SMI"
34 
35 #include <sys/types.h>
36 #include <sys/t_lock.h>
37 #include <sys/proc.h>
38 #include <sys/dditypes.h>
39 
40 #ifdef	__cplusplus
41 extern "C" {
42 #endif
43 
44 /*
45  * The pc_t is the type of the kernel's program counter.  In general, a
46  * pc_t is a uintptr_t -- except for a sparcv9 kernel, in which case all
47  * instruction text is below 4G, and a pc_t is thus a uint32_t.
48  */
49 #ifdef __sparcv9
50 typedef uint32_t pc_t;
51 #else
52 typedef uintptr_t pc_t;
53 #endif
54 
55 /*
56  * Random set of variables used by more than one routine.
57  */
58 
59 #ifdef _KERNEL
60 #include <sys/varargs.h>
61 #include <sys/uadmin.h>
62 
63 extern int hz;			/* system clock rate */
64 extern struct vnode *rootdir;	/* pointer to vnode of root directory */
65 extern struct vnode *devicesdir;	/* pointer to /devices vnode */
66 extern volatile clock_t lbolt;	/* time in HZ since last boot */
67 extern volatile int64_t lbolt64;	/* lbolt computed as 64-bit value */
68 extern int interrupts_unleashed;	/* set after the spl0() in main() */
69 
70 extern char runin;		/* scheduling flag */
71 extern char runout;		/* scheduling flag */
72 extern char wake_sched;		/* causes clock to wake swapper on next tick */
73 extern char wake_sched_sec;	/* causes clock to wake swapper after a sec */
74 
75 extern pgcnt_t	maxmem;		/* max available memory (pages) */
76 extern pgcnt_t	physmem;	/* physical memory (pages) on this CPU */
77 extern pfn_t	physmax;	/* highest numbered physical page present */
78 extern pgcnt_t	physinstalled;	/* physical pages including PROM/boot use */
79 
80 extern caddr_t	s_text;		/* start of kernel text segment */
81 extern caddr_t	e_text;		/* end of kernel text segment */
82 extern caddr_t	s_data;		/* start of kernel text segment */
83 extern caddr_t	e_data;		/* end of kernel text segment */
84 
85 extern pgcnt_t	availrmem;	/* Available resident (not swapable)	*/
86 				/* memory in pages.			*/
87 extern pgcnt_t	availrmem_initial;	/* initial value of availrmem	*/
88 extern pgcnt_t	segspt_minfree;	/* low water mark for availrmem in seg_spt */
89 extern pgcnt_t	freemem;	/* Current free memory.			*/
90 
91 extern dev_t	rootdev;	/* device of the root */
92 extern struct vnode *rootvp;	/* vnode of root device */
93 extern int	root_is_svm;	/* root is a mirrored device flag */
94 extern char *volatile panicstr;	/* panic string pointer */
95 extern va_list  panicargs;	/* panic arguments */
96 
97 extern int	rstchown;	/* 1 ==> restrictive chown(2) semantics */
98 extern int	klustsize;
99 
100 extern int	abort_enable;	/* Platform input-device abort policy */
101 
102 #ifdef C2_AUDIT
103 extern int	audit_active;	/* C2 auditing activate 1, absent 0. */
104 #endif
105 
106 extern int	avenrun[];	/* array of load averages */
107 
108 extern char *isa_list;		/* For sysinfo's isalist option */
109 
110 extern int noexec_user_stack;		/* patchable via /etc/system */
111 extern int noexec_user_stack_log;	/* patchable via /etc/system */
112 
113 /*
114  * Use NFS client operations in the global zone only.  Under contract with
115  * admin/install; do not change without coordinating with that consolidation.
116  */
117 extern int nfs_global_client_only;
118 
119 extern void report_stack_exec(proc_t *, caddr_t);
120 
121 extern void startup(void);
122 extern void clkstart(void);
123 extern void post_startup(void);
124 extern void kern_setup1(void);
125 extern void ka_init(void);
126 extern void nodename_set(void);
127 
128 /*
129  * for tod fault detection
130  */
131 enum tod_fault_type {
132 	TOD_REVERSED = 0,
133 	TOD_STALLED,
134 	TOD_JUMPED,
135 	TOD_RATECHANGED,
136 	TOD_NOFAULT
137 };
138 
139 extern time_t tod_validate(time_t);
140 extern void tod_fault_reset(void);
141 extern void plat_tod_fault(enum tod_fault_type);
142 
143 #ifndef _LP64
144 #ifndef min
145 int min(int, int);
146 #endif
147 
148 #ifndef max
149 int max(int, int);
150 #endif
151 
152 uint_t umin(uint_t, uint_t);
153 uint_t umax(uint_t, uint_t);
154 #endif /* !_LP64 */
155 int grow(caddr_t);
156 int grow_internal(caddr_t, uint_t);
157 int brk_internal(caddr_t, uint_t);
158 timeout_id_t timeout(void (*)(void *), void *, clock_t);
159 timeout_id_t realtime_timeout(void (*)(void *), void *, clock_t);
160 clock_t untimeout(timeout_id_t);
161 void delay(clock_t);
162 int delay_sig(clock_t);
163 int nodev();
164 int nulldev();
165 major_t getudev(void);
166 int cmpldev(dev32_t *, dev_t);
167 dev_t expldev(dev32_t);
168 int bcmp(const void *, const void *, size_t) __PURE;
169 int stoi(char **);
170 void numtos(ulong_t, char *);
171 int strident_valid(const char *);
172 void strident_canon(char *, size_t);
173 int getsubopt(char **optionsp, char * const *tokens, char **valuep);
174 char *append_subopt(const char *, size_t, char *, const char *);
175 int ffs(uintmax_t);
176 int copyin(const void *, void *, size_t);
177 void copyin_noerr(const void *, void *, size_t);
178 int xcopyin(const void *, void *, size_t);
179 int xcopyin_nta(const void *, void *, size_t, int);
180 int copyout(const void *, void *, size_t);
181 void copyout_noerr(const void *, void *, size_t);
182 int xcopyout(const void *, void *, size_t);
183 int xcopyout_nta(const void *, void *, size_t, int);
184 int copyinstr(const char *, char *, size_t, size_t *);
185 int copyinstr_noerr(const char *, char *, size_t, size_t *);
186 int copyoutstr(const char *, char *, size_t, size_t *);
187 int copyoutstr_noerr(const char *, char *, size_t, size_t *);
188 int copystr(const char *, char *, size_t, size_t *);
189 void ucopy(const void *, void *, size_t);
190 void ucopystr(const char *, char *, size_t, size_t *);
191 void pgcopy(const void *, void *, size_t);
192 void ovbcopy(const void *, void *, size_t);
193 void uzero(void *, size_t);
194 int kcopy(const void *, void *, size_t);
195 int kcopy_nta(const void *, void *, size_t, int);
196 int kzero(void *, size_t);
197 
198 int fuword8(const void *, uint8_t *);
199 int fuword16(const void *, uint16_t *);
200 int fuword32(const void *, uint32_t *);
201 int fulword(const void *, ulong_t *);
202 void fuword8_noerr(const void *, uint8_t *);
203 void fuword16_noerr(const void *, uint16_t *);
204 void fuword32_noerr(const void *, uint32_t *);
205 void fulword_noerr(const void *, ulong_t *);
206 
207 #ifdef _LP64
208 int fuword64(const void *, uint64_t *);
209 void fuword64_noerr(const void *, uint64_t *);
210 #endif
211 
212 int subyte(void *, uint8_t);
213 int suword8(void *, uint8_t);
214 int suword16(void *, uint16_t);
215 int suword32(void *, uint32_t);
216 int sulword(void *, ulong_t);
217 void subyte_noerr(void *, uint8_t);
218 void suword8_noerr(void *, uint8_t);
219 void suword16_noerr(void *, uint16_t);
220 void suword32_noerr(void *, uint32_t);
221 void sulword_noerr(void *, ulong_t);
222 
223 #ifdef _LP64
224 int suword64(void *, uint64_t);
225 void suword64_noerr(void *, uint64_t);
226 #endif
227 
228 #if !defined(_BOOT)
229 int setjmp(label_t *);
230 extern void longjmp(label_t *)
231 	__NORETURN;
232 #pragma unknown_control_flow(setjmp)
233 #endif
234 
235 caddr_t caller(void);
236 caddr_t callee(void);
237 int getpcstack(pc_t *, int);
238 int on_fault(label_t *);
239 void no_fault(void);
240 void halt(char *);
241 int scanc(size_t, uchar_t *, uchar_t *, uchar_t);
242 int movtuc(size_t, uchar_t *, uchar_t *, uchar_t *);
243 int splr(int);
244 int splhigh(void);
245 int splhi(void);
246 int splzs(void);
247 int spl0(void);
248 int spl6(void);
249 int spl7(void);
250 int spl8(void);
251 void splx(int);
252 void set_base_spl(void);
253 int __ipltospl(int);
254 
255 void softcall_init(void);
256 void softcall(void (*)(void *), void *);
257 void softint(void);
258 
259 extern void sync_icache(caddr_t, uint_t);
260 extern void sync_data_memory(caddr_t, size_t);
261 extern void hot_patch_kernel_text(caddr_t, uint32_t, uint_t);
262 
263 void _insque(caddr_t, caddr_t);
264 void _remque(caddr_t);
265 
266 /* casts to keep lint happy */
267 #define	insque(q, p)	_insque((caddr_t)q, (caddr_t)p)
268 #define	remque(q)	_remque((caddr_t)q)
269 
270 #pragma unknown_control_flow(on_fault)
271 
272 struct timeval;
273 extern void	uniqtime(struct timeval *);
274 struct timeval32;
275 extern void	uniqtime32(struct timeval32 *);
276 
277 uint_t page_num_pagesizes(void);
278 size_t page_get_pagesize(uint_t n);
279 
280 extern int maxusers;
281 extern int pidmax;
282 
283 extern void param_preset(void);
284 extern void param_calc(int);
285 extern void param_init(void);
286 extern void param_check(void);
287 
288 #endif /* _KERNEL */
289 
290 /*
291  * Structure of the system-entry table.
292  *
293  * 	Changes to struct sysent should maintain binary compatibility with
294  *	loadable system calls, although the interface is currently private.
295  *
296  *	This means it should only be expanded on the end, and flag values
297  * 	should not be reused.
298  *
299  *	It is desirable to keep the size of this struct a power of 2 for quick
300  *	indexing.
301  */
302 struct sysent {
303 	char		sy_narg;	/* total number of arguments */
304 #ifdef _LP64
305 	unsigned short	sy_flags;	/* various flags as defined below */
306 #else
307 	unsigned char	sy_flags;	/* various flags as defined below */
308 #endif
309 	int		(*sy_call)();	/* argp, rvalp-style handler */
310 	krwlock_t	*sy_lock;	/* lock for loadable system calls */
311 	int64_t		(*sy_callc)();	/* C-style call hander or wrapper */
312 };
313 
314 extern struct sysent	sysent[];
315 #ifdef _SYSCALL32_IMPL
316 extern struct sysent	sysent32[];
317 #endif
318 
319 extern struct sysent	nosys_ent;	/* entry for invalid system call */
320 
321 #define	NSYSCALL 	256		/* number of system calls */
322 
323 #define	LOADABLE_SYSCALL(s)	(s->sy_flags & SE_LOADABLE)
324 #define	LOADED_SYSCALL(s)	(s->sy_flags & SE_LOADED)
325 
326 /*
327  * sy_flags values
328  * 	Values 1, 2, and 4 were used previously for SETJUMP, ASYNC, and IOSYS.
329  */
330 #define	SE_32RVAL1	0x0		/* handler returns int32_t in rval1 */
331 #define	SE_32RVAL2	0x1		/* handler returns int32_t in rval2 */
332 #define	SE_64RVAL	0x2		/* handler returns int64_t in rvals */
333 #define	SE_RVAL_MASK	0x3		/* mask of rval_t bits */
334 
335 #define	SE_LOADABLE	0x08		/* syscall is loadable */
336 #define	SE_LOADED	0x10		/* syscall is completely loaded */
337 #define	SE_NOUNLOAD	0x20		/* syscall never needs unload */
338 #define	SE_ARGC		0x40		/* syscall takes C-style args */
339 
340 /*
341  * Structure of the return-value parameter passed by reference to
342  * system entries.
343  */
344 union rval {
345 	struct	{
346 		int	r_v1;
347 		int	r_v2;
348 	} r_v;
349 	off_t	r_off;
350 	offset_t r_offset;
351 	time_t	r_time;
352 	int64_t	r_vals;
353 };
354 #define	r_val1	r_v.r_v1
355 #define	r_val2	r_v.r_v2
356 
357 typedef union rval rval_t;
358 
359 #ifdef	_KERNEL
360 
361 extern void reset_syscall_args(void);
362 extern int save_syscall_args(void);
363 extern uint_t get_syscall_args(klwp_t *lwp, long *argp, int *nargsp);
364 #ifdef _SYSCALL32_IMPL
365 extern uint_t get_syscall32_args(klwp_t *lwp, int *argp, int *nargp);
366 #endif
367 
368 extern uint_t set_errno(uint_t error);
369 #pragma rarely_called(set_errno)
370 
371 extern int64_t syscall_ap(void);
372 extern int64_t loadable_syscall(long, long, long, long, long, long, long, long);
373 extern int64_t nosys(void);
374 
375 extern void swtch(void);
376 
377 extern uint_t	kcpc_key;	/* TSD key for performance counter context */
378 
379 /*
380  * initname holds the path to init and is used as a point of rendezvous
381  * between krtld (which processes the boot arguments) and the kernel.
382  */
383 #define	INITNAME_SZ	32
384 extern char initname[INITNAME_SZ];
385 
386 /*
387  * initargs holds the arguments to init (such as -v, -s, -r, -m verbose) and
388  * is a point of rendezvous between krtld (which processes the boot arguments)
389  * and the kernel.
390  */
391 extern char initargs[BOOTARGS_MAX];
392 
393 extern int exec_init(const char *, const char *);
394 extern int start_init_common(void);
395 
396 #endif	/* _KERNEL */
397 
398 #if defined(_KERNEL) || defined(_BOOT)
399 
400 size_t strlcat(char *, const char *, size_t);
401 size_t strlen(const char *) __PURE;
402 char *strcat(char *, const char *);
403 char *strncat(char *, const char *, size_t);
404 char *strcpy(char *, const char *);
405 char *strncpy(char *, const char *, size_t);
406 /* Need to be consistent with <string.h> C++ definitions */
407 #if __cplusplus >= 199711L
408 extern const char *strchr(const char *, int);
409 #ifndef _STRCHR_INLINE
410 #define	_STRCHR_INLINE
411 extern "C++" {
412 	inline char *strchr(char *__s, int __c) {
413 		return (char *)strchr((const char *)__s, __c);
414 	}
415 }
416 #endif /* _STRCHR_INLINE */
417 extern const char *strrchr(const char *, int);
418 #ifndef	_STRRCHR_INLINE
419 #define	_STRRCHR_INLINE
420 extern "C++" {
421 	inline char *strrchr(char *__s, int __c) {
422 		return (char *)strrchr((const char *)__s, __c);
423 	}
424 }
425 #endif	/* _STRRCHR_INLINE */
426 extern const char *strstr(const char *, const char *);
427 #ifndef	_STRSTR_INLINE
428 #define	_STRSTR_INLINE
429 extern "C++" {
430 	inline char *strstr(char *__s1, const char *__s2) {
431 		return (char *)strstr((const char *)__s1, __s2);
432 	}
433 }
434 #endif  /* _STRSTR_INLINE */
435 #else	/* __cplusplus >= 199711L */
436 char *strchr(const char *, int);
437 char *strrchr(const char *, int);
438 char *strstr(const char *, const char *);
439 #endif	/* __cplusplus >= 199711L */
440 char *strnrchr(const char *, int, size_t);
441 int strcmp(const char *, const char *) __PURE;
442 int strncmp(const char *, const char *, size_t) __PURE;
443 int strcasecmp(const char *, const char *) __PURE;
444 int strncasecmp(const char *, const char *, size_t) __PURE;
445 /* Need to be consistent with <string.h> C++ definitions */
446 #if __cplusplus >= 199711L
447 extern const char *strpbrk(const char *, const char *);
448 #ifndef _STRPBRK_INLINE
449 #define	_STRPBRK_INLINE
450 extern "C++" {
451 	inline char *strpbrk(char *__s1, const char *__s2) {
452 		return (char *)strpbrk((const char *)__s1, __s2);
453 	}
454 }
455 #endif /* _STRPBRK_INLINE */
456 #else /* __cplusplus >= 199711L */
457 char *strpbrk(const char *, const char *);
458 #endif /* __cplusplus >= 199711L */
459 void bcopy(const void *, void *, size_t);
460 void bzero(void *, size_t);
461 
462 extern void *memset(void *, int, size_t);
463 extern void *memcpy(void *, const void *, size_t);
464 extern void *memmove(void *, const void *, size_t);
465 extern int memcmp(const void *, const void *, size_t);
466 
467 #ifdef __lint
468 extern	int	__lintzero;	/* for spoofing lint */
469 #else	/* __lint */
470 #define	__lintzero 0
471 #endif	/* __lint */
472 #endif /* _KERNEL || _BOOT */
473 
474 #ifdef	__cplusplus
475 }
476 #endif
477 
478 #endif	/* _SYS_SYSTM_H */
479