xref: /illumos-gate/usr/src/uts/common/sys/modctl.h (revision 97088f6e9a2eb4c0085fb27842bd398fcba75846)
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  * Copyright (c) 1990, 2010, Oracle and/or its affiliates. All rights reserved.
23  * Copyright 2025 Oxide Computer Company
24  */
25 
26 #ifndef	_SYS_MODCTL_H
27 #define	_SYS_MODCTL_H
28 
29 /*
30  * loadable module support.
31  */
32 
33 #include <sys/types.h>
34 #include <sys/ioccom.h>
35 #include <sys/nexusdefs.h>
36 #include <sys/thread.h>
37 #include <sys/t_lock.h>
38 #include <sys/dditypes.h>
39 #include <sys/hwconf.h>
40 
41 #ifdef	__cplusplus
42 extern "C" {
43 #endif
44 
45 /*
46  * The following structure defines the operations used by modctl
47  * to load and unload modules.  Each supported loadable module type
48  * requires a set of mod_ops.
49  */
50 struct mod_ops {
51 	int		(*modm_install)();	/* install module in kernel */
52 	int		(*modm_remove)();	/* remove from kernel */
53 	int		(*modm_info)();		/* module info */
54 };
55 
56 #ifdef _KERNEL
57 
58 /*
59  * The defined set of mod_ops structures for each loadable module type
60  * Defined in modctl.c
61  */
62 extern struct mod_ops mod_brandops;
63 #if defined(__i386) || defined(__amd64)
64 extern struct mod_ops mod_cpuops;
65 #endif
66 extern struct mod_ops mod_cryptoops;
67 extern struct mod_ops mod_driverops;
68 extern struct mod_ops mod_execops;
69 extern struct mod_ops mod_fsops;
70 extern struct mod_ops mod_miscops;
71 extern struct mod_ops mod_schedops;
72 extern struct mod_ops mod_strmodops;
73 extern struct mod_ops mod_syscallops;
74 extern struct mod_ops mod_sockmodops;
75 #ifdef _SYSCALL32_IMPL
76 extern struct mod_ops mod_syscallops32;
77 #endif
78 extern struct mod_ops mod_dacfops;
79 extern struct mod_ops mod_ippops;
80 extern struct mod_ops mod_pcbeops;
81 extern struct mod_ops mod_kiconvops;
82 
83 #endif /* _KERNEL */
84 
85 /*
86  * Definitions for the module specific linkage structures.
87  * The first two fields are the same in all of the structures.
88  * The linkinfo is for informational purposes only and is returned by
89  * modctl with the MODINFO cmd.
90  */
91 
92 /* For drivers */
93 struct modldrv {
94 	struct mod_ops		*drv_modops;
95 	char			*drv_linkinfo;
96 	struct dev_ops		*drv_dev_ops;
97 };
98 
99 /* For system calls */
100 struct modlsys {
101 	struct mod_ops		*sys_modops;
102 	char			*sys_linkinfo;
103 	struct sysent		*sys_sysent;
104 };
105 
106 /* For filesystems */
107 struct modlfs {
108 	struct mod_ops		*fs_modops;
109 	char			*fs_linkinfo;
110 	struct vfsdef_v5	*fs_vfsdef;	/* version may actually vary */
111 };
112 
113 #if defined(__i386) || defined(__amd64)
114 struct cmi_ops;
115 
116 /* For CPU modules */
117 struct modlcpu {
118 	struct mod_ops		*cpu_modops;
119 	char			*cpu_linkinfo;
120 	struct cmi_ops		*cpu_cmiops;
121 };
122 #endif
123 
124 /* For cryptographic providers */
125 struct modlcrypto {
126 	struct mod_ops		*crypto_modops;
127 	char			*crypto_linkinfo;
128 };
129 
130 /* For misc */
131 struct modlmisc {
132 	struct mod_ops		*misc_modops;
133 	char			*misc_linkinfo;
134 };
135 
136 /* For IP Modules */
137 struct modlipp {
138 	struct mod_ops		*ipp_modops;
139 	char			*ipp_linkinfo;
140 	struct ipp_ops		*ipp_ops;
141 };
142 
143 /* For Streams Modules. */
144 struct modlstrmod {
145 	struct mod_ops		*strmod_modops;
146 	char			*strmod_linkinfo;
147 	struct fmodsw		*strmod_fmodsw;
148 };
149 
150 /* For Scheduling classes */
151 struct modlsched {
152 	struct mod_ops		*sched_modops;
153 	char			*sched_linkinfo;
154 	struct sclass		*sched_class;
155 };
156 
157 /* For Exec file type (like ELF, ...) */
158 struct modlexec {
159 	struct mod_ops		*exec_modops;
160 	char			*exec_linkinfo;
161 	struct execsw		*exec_execsw;
162 };
163 
164 /* For dacf modules */
165 struct modldacf {
166 	struct mod_ops		*dacf_modops;
167 	char			*dacf_linkinfo;
168 	struct dacfsw		*dacf_dacfsw;
169 };
170 
171 /* For PCBE modules */
172 struct modlpcbe {
173 	struct mod_ops		*pcbe_modops;
174 	char			*pcbe_linkinfo;
175 	struct __pcbe_ops	*pcbe_ops;
176 };
177 
178 /* For Brand modules */
179 struct modlbrand {
180 	struct mod_ops		*brand_modops;
181 	char			*brand_linkinfo;
182 	struct brand		*brand_branddef;
183 };
184 
185 /* For socket Modules. */
186 struct modlsockmod {
187 	struct mod_ops		*sockmod_modops;
188 	char			*sockmod_linkinfo;
189 	struct smod_reg_s	*sockmod_reg_info;
190 };
191 
192 /* For kiconv modules */
193 struct modlkiconv {
194 	struct mod_ops		*kiconv_modops;
195 	char			*kiconv_linkinfo;
196 	struct kiconv_mod_info	*kiconv_moddef;
197 };
198 
199 /*
200  * Revision number of loadable modules support.  This is the value
201  * that must be used in the modlinkage structure.
202  */
203 #define	MODREV_1		1
204 
205 /*
206  * The modlinkage structure is the structure that the module writer
207  * provides to the routines to install, remove, and stat a module.
208  * The ml_linkage element is an array of pointers to linkage structures.
209  * For most modules there is only one linkage structure.  We allocate
210  * enough space for 3 linkage structures which happens to be the most
211  * we have in any sun supplied module.  For those modules with more
212  * than 3 linkage structures (which is very unlikely), a modlinkage
213  * structure must be kmem_alloc'd in the module wrapper to be big enough
214  * for all of the linkage structures.
215  */
216 struct modlinkage {
217 	int		ml_rev;		/* rev of loadable modules system */
218 #ifdef _LP64
219 	void		*ml_linkage[7];	/* more space in 64-bit OS */
220 #else
221 	void		*ml_linkage[4];	/* NULL terminated list of */
222 					/* linkage structures */
223 #endif
224 };
225 
226 /*
227  * commands.  These are the commands supported by the modctl system call.
228  */
229 #define	MODLOAD			0
230 #define	MODUNLOAD		1
231 #define	MODINFO			2
232 #define	MODRESERVED		3
233 #define	MODSETMINIROOT		4
234 #define	MODADDMAJBIND		5
235 #define	MODGETPATH		6
236 #define	MODREADSYSBIND		7
237 #define	MODGETMAJBIND		8
238 #define	MODGETNAME		9
239 #define	MODSIZEOF_DEVID		10
240 #define	MODGETDEVID		11
241 #define	MODSIZEOF_MINORNAME	12
242 #define	MODGETMINORNAME		13
243 #define	MODGETPATHLEN		14
244 #define	MODEVENTS		15
245 #define	MODGETFBNAME		16
246 #define	MODREREADDACF		17
247 #define	MODLOADDRVCONF		18
248 #define	MODUNLOADDRVCONF	19
249 #define	MODREMMAJBIND		20
250 #define	MODDEVT2INSTANCE	21
251 #define	MODGETDEVFSPATH_LEN	22
252 #define	MODGETDEVFSPATH		23
253 #define	MODDEVID2PATHS		24
254 #define	MODSETDEVPOLICY		26
255 #define	MODGETDEVPOLICY		27
256 #define	MODALLOCPRIV		28
257 #define	MODGETDEVPOLICYBYNAME	29
258 #define	MODLOADMINORPERM	31
259 #define	MODADDMINORPERM		32
260 #define	MODREMMINORPERM		33
261 #define	MODREMDRVCLEANUP	34
262 #define	MODDEVEXISTS		35
263 #define	MODDEVREADDIR		36
264 #define	MODDEVNAME		37
265 #define	MODGETDEVFSPATH_MI_LEN	38
266 #define	MODGETDEVFSPATH_MI	39
267 #define	MODRETIRE		40
268 #define	MODUNRETIRE		41
269 #define	MODISRETIRED		42
270 #define	MODDEVEMPTYDIR		43
271 #define	MODREMDRVALIAS		44
272 #define	MODHPOPS		45
273 
274 /*
275  * sub cmds for MODEVENTS
276  */
277 #define	MODEVENTS_FLUSH				0
278 #define	MODEVENTS_FLUSH_DUMP			1
279 #define	MODEVENTS_SET_DOOR_UPCALL_FILENAME	2
280 #define	MODEVENTS_GETDATA			3
281 #define	MODEVENTS_FREEDATA			4
282 #define	MODEVENTS_POST_EVENT			5
283 #define	MODEVENTS_REGISTER_EVENT		6
284 
285 /*
286  * devname subcmds for MODDEVNAME
287  */
288 #define	MODDEVNAME_LOOKUPDOOR	0
289 #define	MODDEVNAME_PROFILE	3
290 #define	MODDEVNAME_RECONFIG	4
291 #define	MODDEVNAME_SYSAVAIL	5
292 
293 /*
294  * subcmds for MODHPOPS
295  */
296 #define	MODHPOPS_CHANGE_STATE	0
297 #define	MODHPOPS_CREATE_PORT	1
298 #define	MODHPOPS_REMOVE_PORT	2
299 #define	MODHPOPS_BUS_GET	3
300 #define	MODHPOPS_BUS_SET	4
301 
302 
303 /*
304  * Data structure passed to modconfig command in kernel to build devfs tree
305  */
306 
307 struct aliases {
308 	struct aliases *a_next;
309 	char *a_name;
310 	int a_len;
311 };
312 
313 #define	MAXMODCONFNAME	256
314 
315 struct modconfig {
316 	char drvname[MAXMODCONFNAME];
317 	char drvclass[MAXMODCONFNAME];
318 	int major;
319 	int flags;
320 	int num_aliases;
321 	struct aliases *ap;
322 };
323 
324 #if defined(_SYSCALL32)
325 
326 struct aliases32 {
327 	caddr32_t a_next;
328 	caddr32_t a_name;
329 	int32_t a_len;
330 };
331 
332 struct modconfig32 {
333 	char drvname[MAXMODCONFNAME];
334 	char drvclass[MAXMODCONFNAME];
335 	int32_t major;
336 	int32_t flags;
337 	int32_t num_aliases;
338 	caddr32_t ap;
339 };
340 
341 #endif /* _SYSCALL32 */
342 
343 /* flags for modconfig */
344 #define	MOD_UNBIND_OVERRIDE	0x01		/* fail unbind if in use */
345 #define	MOD_ADDMAJBIND_UPDATE	0x02		/* update only, do not load */
346 
347 /* flags for MODLOADDRVCONF - modctl_load_drvconf() */
348 #define	MOD_LOADDRVCONF_RECONF	0x01		/* complete configuration */
349 						/* after update-only */
350 
351 /*
352  * Max module path length
353  */
354 #define	MOD_MAXPATH	256
355 
356 /*
357  * Default search path for modules ADDITIONAL to the directory
358  * where the kernel components we booted from are.
359  *
360  * Most often, this will be "/platform/{platform}/kernel /kernel /usr/kernel",
361  * but we don't wire it down here.
362  */
363 #define	MOD_DEFPATH	"/kernel /usr/kernel"
364 
365 /*
366  * Default file name extension for autoloading modules.
367  */
368 #define	MOD_DEFEXT	""
369 
370 /*
371  * Parameters for modinfo
372  */
373 #define	MODMAXNAMELEN 32		/* max module name length */
374 #define	MODMAXLINKINFOLEN 32		/* max link info length */
375 
376 /*
377  * Module specific information.
378  */
379 struct modspecific_info {
380 	char	msi_linkinfo[MODMAXLINKINFOLEN]; /* name in linkage struct */
381 	int	msi_p0;			/* module specific information */
382 };
383 
384 /*
385  * Structure returned by modctl with MODINFO command.
386  */
387 #define	MODMAXLINK 10			/* max linkages modinfo can handle */
388 
389 struct modinfo {
390 	int		   mi_info;		/* Flags for info wanted */
391 	int		   mi_state;		/* Flags for module state */
392 	int		   mi_id;		/* id of this loaded module */
393 	int		   mi_nextid;		/* id of next module or -1 */
394 	caddr_t		   mi_base;		/* virtual addr of text */
395 	size_t		   mi_size;		/* size of module in bytes */
396 	int		   mi_rev;		/* loadable modules rev */
397 	int		   mi_loadcnt;		/* # of times loaded */
398 	char		   mi_name[MODMAXNAMELEN]; /* name of module */
399 	struct modspecific_info mi_msinfo[MODMAXLINK];
400 						/* mod specific info */
401 };
402 
403 
404 #if defined(_SYSCALL32)
405 
406 #define	MODMAXNAMELEN32 32		/* max module name length */
407 #define	MODMAXLINKINFOLEN32 32		/* max link info length */
408 #define	MODMAXLINK32 10			/* max linkages modinfo can handle */
409 
410 struct modspecific_info32 {
411 	char	msi_linkinfo[MODMAXLINKINFOLEN32]; /* name in linkage struct */
412 	int32_t	msi_p0;			/* module specific information */
413 };
414 
415 struct modinfo32 {
416 	int32_t		   mi_info;		/* Flags for info wanted */
417 	int32_t		   mi_state;		/* Flags for module state */
418 	int32_t		   mi_id;		/* id of this loaded module */
419 	int32_t		   mi_nextid;		/* id of next module or -1 */
420 	caddr32_t	   mi_base;		/* virtual addr of text */
421 	uint32_t	   mi_size;		/* size of module in bytes */
422 	int32_t		   mi_rev;		/* loadable modules rev */
423 	int32_t		   mi_loadcnt;		/* # of times loaded */
424 	char		   mi_name[MODMAXNAMELEN32]; /* name of module */
425 	struct modspecific_info32 mi_msinfo[MODMAXLINK32];
426 						/* mod specific info */
427 };
428 
429 #endif /* _SYSCALL32 */
430 
431 /* Values for mi_info flags */
432 #define	MI_INFO_ONE	(1 << 0)
433 #define	MI_INFO_ALL	(1 << 1)
434 #define	MI_INFO_CNT	(1 << 2)
435 #ifdef _KERNEL
436 /* used internally to extract modlinkage */
437 #define	MI_INFO_LINKAGE	(1 << 3)
438 #endif
439 /*
440  * MI_INFO_NOBASE indicates caller does not need mi_base. Failure to use this
441  * flag may lead 32-bit apps to receive an EOVERFLOW error from modctl(MODINFO)
442  * when used with a 64-bit kernel.
443  */
444 #define	MI_INFO_NOBASE	(1 << 4)
445 /* Query by-name, rather than by-id, when used with MI_INFO_ONE */
446 #define	MI_INFO_BY_NAME	(1 << 5)
447 
448 /* Values for mi_state */
449 #define	MI_LOADED	1
450 #define	MI_INSTALLED	2
451 
452 /*
453  * Macros to vector to the appropriate module specific routine.
454  */
455 #define	MODL_INSTALL(MODL, MODLP) \
456 	(*(MODL)->misc_modops->modm_install)(MODL, MODLP)
457 #define	MODL_REMOVE(MODL, MODLP) \
458 	(*(MODL)->misc_modops->modm_remove)(MODL, MODLP)
459 #define	MODL_INFO(MODL, MODLP, P0) \
460 	(*(MODL)->misc_modops->modm_info)(MODL, MODLP, P0)
461 
462 /*
463  * Definitions for stubs
464  */
465 struct mod_stub_info {
466 	uintptr_t mods_func_adr;
467 	struct mod_modinfo *mods_modinfo;
468 	uintptr_t mods_stub_adr;
469 	int (*mods_errfcn)();
470 	int mods_flag;			/* flags defined below */
471 };
472 
473 /*
474  * Definitions for mods_flag.
475  */
476 #define	MODS_WEAK	0x01		/* weak stub (not loaded if called) */
477 #define	MODS_NOUNLOAD	0x02		/* module not unloadable (no _fini()) */
478 #define	MODS_INSTALLED	0x10		/* module installed */
479 
480 struct mod_modinfo {
481 	char *modm_module_name;
482 	struct modctl *mp;
483 	struct mod_stub_info modm_stubs[1];
484 };
485 
486 struct modctl_list {
487 	struct modctl_list *modl_next;
488 	struct modctl *modl_modp;
489 };
490 
491 /*
492  * Structure to manage a loadable module.
493  * Note: the module (mod_mp) structure's "text" and "text_size" information
494  * are replicated in the modctl structure so that mod_containing_pc()
495  * doesn't have to grab any locks (modctls are persistent; modules are not.)
496  */
497 typedef struct modctl {
498 	struct modctl	*mod_next;	/* &modules based list */
499 	struct modctl	*mod_prev;
500 	int		mod_id;
501 	void		*mod_mp;
502 	kthread_t	*mod_inprogress_thread;
503 	struct mod_modinfo *mod_modinfo;
504 	struct modlinkage *mod_linkage;
505 	char		*mod_filename;
506 	char		*mod_modname;
507 
508 	char		mod_busy;	/* inprogress_thread has locked */
509 	char		mod_want;	/* someone waiting for unlock */
510 	char		mod_prim;	/* primary module */
511 
512 	int		mod_ref;	/* ref count - from dependent or stub */
513 
514 	char		mod_loaded;	/* module in memory */
515 	char		mod_installed;	/* post _init pre _fini */
516 	char		mod_loadflags;
517 	char		mod_delay_unload;	/* deferred unload */
518 
519 	struct modctl_list *mod_requisites;	/* mods this one depends on. */
520 	void		*mod_unused;	/* NOTE: reuse (same size) is OK, */
521 					/* deletion causes mdb.vs.core issues */
522 	int		mod_loadcnt;	/* number of times mod was loaded */
523 	int		mod_nenabled;	/* # of enabled DTrace probes in mod */
524 	char		*mod_text;
525 	size_t		mod_text_size;
526 
527 	int		mod_gencount;	/* # times loaded/unloaded */
528 	struct modctl	*mod_requisite_loading;	/* mod circular dependency */
529 } modctl_t;
530 
531 /*
532  * mod_loadflags
533  */
534 
535 #define	MOD_NOAUTOUNLOAD	0x1	/* Auto mod-unloader skips this mod */
536 #define	MOD_NONOTIFY		0x2	/* No krtld notifications on (un)load */
537 #define	MOD_NOUNLOAD		0x4	/* Assume EBUSY for all _fini's */
538 
539 
540 #ifdef _KERNEL
541 
542 #define	MOD_BIND_HASHSIZE	64
543 #define	MOD_BIND_HASHMASK	(MOD_BIND_HASHSIZE-1)
544 
545 typedef int modid_t;
546 
547 /*
548  * global function and data declarations
549  */
550 extern kmutex_t mod_lock;
551 
552 extern char *systemfile;
553 extern char *self_assembly;
554 extern char **syscallnames;
555 extern int moddebug;
556 
557 /*
558  * this is the head of a doubly linked list.  Only the next and prev
559  * pointers are used
560  */
561 extern modctl_t modules;
562 
563 extern int modload_qualified(const char *,
564     const char *, const char *, const char *, uint_t[], int, int *);
565 
566 extern void	mod_setup(void);
567 extern int	modload(const char *, const char *);
568 extern int	modloadonly(const char *, const char *);
569 extern int	modunload(int);
570 extern int	mod_hold_stub(struct mod_stub_info *);
571 extern void	modunload_disable(void);
572 extern void	modunload_enable(void);
573 extern void	modunload_begin(void);
574 extern void	modunload_end(void);
575 extern int	mod_remove_by_name(char *);
576 extern int	mod_sysvar(const char *, const char *, u_longlong_t *);
577 extern int	mod_sysctl(int, void *);
578 struct sysparam;
579 extern int	mod_hold_by_modctl(modctl_t *, int);
580 #define		MOD_WAIT_ONCE		0x01
581 #define		MOD_WAIT_FOREVER	0x02
582 #define		MOD_LOCK_HELD		0x04
583 #define		MOD_LOCK_NOT_HELD	0x08
584 extern int	mod_sysctl_type(int, int (*)(struct sysparam *, void *),
585     void *);
586 extern void	mod_read_system_file(int);
587 extern void	mod_release_stub(struct mod_stub_info *);
588 extern void	mod_askparams(void);
589 extern void	mod_uninstall_daemon(void);
590 extern void	modreap(void);
591 extern modctl_t *mod_hold_by_id(modid_t);
592 extern modctl_t *mod_hold_by_name(const char *);
593 extern void	mod_release_mod(modctl_t *);
594 extern uintptr_t modlookup(const char *, const char *);
595 extern uintptr_t modlookup_by_modctl(modctl_t *, const char *);
596 extern char	*modgetsymname(uintptr_t, unsigned long *);
597 extern void	mod_release_requisites(modctl_t *);
598 extern modctl_t *mod_load_requisite(modctl_t *, char *);
599 extern modctl_t *mod_find_by_filename(char *, char *);
600 extern uintptr_t	modgetsymvalue(char *, int);
601 
602 extern int	major_valid(major_t);
603 extern int	driver_installed(major_t);
604 extern int	driver_active(major_t);
605 
606 extern void	mod_rele_dev_by_major(major_t);
607 extern struct dev_ops *mod_hold_dev_by_major(major_t);
608 extern struct dev_ops *mod_hold_dev_by_devi(dev_info_t *);
609 extern void	mod_rele_dev_by_devi(dev_info_t *);
610 
611 extern int make_devname(const char *, major_t, int);
612 extern int gmatch(const char *, const char *);
613 
614 extern void make_aliases(struct bind **);
615 extern int read_binding_file(char *, struct bind **,
616     int (*line_parser)(char *, int, char *, struct bind **));
617 extern void clear_binding_hash(struct bind **);
618 
619 extern void read_class_file(void);
620 extern void setbootpath(char *);
621 extern void setbootfstype(char *);
622 
623 extern int install_stubs_by_name(modctl_t *, const char *);
624 extern void install_stubs(modctl_t *);
625 extern void uninstall_stubs(modctl_t *);
626 extern void reset_stubs(modctl_t *);
627 extern modctl_t *mod_getctl(struct modlinkage *);
628 extern major_t mod_name_to_major(const char *);
629 extern modid_t mod_name_to_modid(const char *);
630 extern char *mod_major_to_name(major_t);
631 extern void init_devnamesp(int);
632 extern void init_syscallnames(int);
633 
634 extern char *mod_getsysname(int);
635 extern int mod_getsysnum(const char *);
636 
637 extern char *mod_containing_pc(caddr_t);
638 extern int mod_in_autounload(void);
639 extern const char *mod_modname(struct modlinkage *);
640 
641 extern int dev_minorperm(dev_info_t *, char *, mperm_t *);
642 extern void dev_devices_cleanup(void);
643 
644 /*
645  * Declarations used for dynamic linking support routines.  Interfaces
646  * are marked with the pragma "unknown_control_flow" to prevent tail call
647  * optimization, so that implementations can reliably use caller() to
648  * determine initiating module.
649  */
650 #define	KRTLD_MODE_FIRST	0x0001
651 typedef	struct __ddi_modhandle	*ddi_modhandle_t;
652 extern ddi_modhandle_t		ddi_modopen(const char *,
653 				    int, int *);
654 extern void			*ddi_modsym(ddi_modhandle_t,
655 				    const char *, int *);
656 extern int			ddi_modclose(ddi_modhandle_t);
657 #pragma	unknown_control_flow(ddi_modopen, ddi_modsym, ddi_modclose)
658 
659 /*
660  * Only the following are part of the DDI/DKI
661  */
662 extern int	_init(void);
663 extern int	_fini(void);
664 extern int	_info(struct modinfo *);
665 extern int	mod_install(struct modlinkage *);
666 extern int	mod_remove(struct modlinkage *);
667 extern int	mod_info(struct modlinkage *, struct modinfo *);
668 
669 #else	/* _KERNEL */
670 
671 extern int modctl(int, ...);
672 
673 #endif	/* _KERNEL */
674 
675 /*
676  * bit definitions for moddebug.
677  */
678 #define	MODDEBUG_LOADMSG	0x80000000	/* print "[un]loading..." msg */
679 #define	MODDEBUG_ERRMSG		0x40000000	/* print detailed error msgs */
680 #define	MODDEBUG_LOADMSG2	0x20000000	/* print 2nd level msgs */
681 #define	MODDEBUG_RETIRE		0x10000000	/* print retire msgs */
682 #define	MODDEBUG_BINDING	0x00040000	/* driver/alias binding */
683 #define	MODDEBUG_FINI_EBUSY	0x00020000	/* pretend fini returns EBUSY */
684 #define	MODDEBUG_NOAUL_IPP	0x00010000	/* no Autounloading ipp mods */
685 #define	MODDEBUG_NOAUL_DACF	0x00008000	/* no Autounloading dacf mods */
686 #define	MODDEBUG_KEEPTEXT	0x00004000	/* keep text after unloading */
687 #define	MODDEBUG_NOAUL_DRV	0x00001000	/* no Autounloading Drivers */
688 #define	MODDEBUG_NOAUL_EXEC	0x00000800	/* no Autounloading Execs */
689 #define	MODDEBUG_NOAUL_FS	0x00000400	/* no Autounloading File sys */
690 #define	MODDEBUG_NOAUL_MISC	0x00000200	/* no Autounloading misc */
691 #define	MODDEBUG_NOAUL_SCHED	0x00000100	/* no Autounloading scheds */
692 #define	MODDEBUG_NOAUL_STR	0x00000080	/* no Autounloading streams */
693 #define	MODDEBUG_NOAUL_SYS	0x00000040	/* no Autounloading syscalls */
694 #define	MODDEBUG_NOCTF		0x00000020	/* do not load CTF debug data */
695 #define	MODDEBUG_NOAUTOUNLOAD	0x00000010	/* no autounloading at all */
696 #define	MODDEBUG_DDI_MOD	0x00000008	/* ddi_mod{open,sym,close} */
697 #define	MODDEBUG_MP_MATCH	0x00000004	/* dev_minorperm */
698 #define	MODDEBUG_MINORPERM	0x00000002	/* minor perm modctls */
699 #define	MODDEBUG_USERDEBUG	0x00000001	/* bpt after init_module() */
700 
701 #ifdef	__cplusplus
702 }
703 #endif
704 
705 #endif	/* _SYS_MODCTL_H */
706