Home | History | Annotate | Download | only in sys
      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 2009 Sun Microsystems, Inc.  All rights reserved.
     23  * Use is subject to license terms.
     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
    433 #define	MI_INFO_ALL	2
    434 #define	MI_INFO_CNT	4
    435 #ifdef _KERNEL
    436 #define	MI_INFO_LINKAGE	8	/* used internally to extract modlinkage */
    437 #endif
    438 /*
    439  * MI_INFO_NOBASE indicates caller does not need mi_base. Failure to use this
    440  * flag may lead 32-bit apps to receive an EOVERFLOW error from modctl(MODINFO)
    441  * when used with a 64-bit kernel.
    442  */
    443 #define	MI_INFO_NOBASE	16
    444 
    445 /* Values for mi_state */
    446 #define	MI_LOADED	1
    447 #define	MI_INSTALLED	2
    448 
    449 /*
    450  * Macros to vector to the appropriate module specific routine.
    451  */
    452 #define	MODL_INSTALL(MODL, MODLP) \
    453 	(*(MODL)->misc_modops->modm_install)(MODL, MODLP)
    454 #define	MODL_REMOVE(MODL, MODLP) \
    455 	(*(MODL)->misc_modops->modm_remove)(MODL, MODLP)
    456 #define	MODL_INFO(MODL, MODLP, P0) \
    457 	(*(MODL)->misc_modops->modm_info)(MODL, MODLP, P0)
    458 
    459 /*
    460  * Definitions for stubs
    461  */
    462 struct mod_stub_info {
    463 	uintptr_t mods_func_adr;
    464 	struct mod_modinfo *mods_modinfo;
    465 	uintptr_t mods_stub_adr;
    466 	int (*mods_errfcn)();
    467 	int mods_flag;			/* flags defined below */
    468 };
    469 
    470 /*
    471  * Definitions for mods_flag.
    472  */
    473 #define	MODS_WEAK	0x01		/* weak stub (not loaded if called) */
    474 #define	MODS_NOUNLOAD	0x02		/* module not unloadable (no _fini()) */
    475 #define	MODS_INSTALLED	0x10		/* module installed */
    476 
    477 struct mod_modinfo {
    478 	char *modm_module_name;
    479 	struct modctl *mp;
    480 	struct mod_stub_info modm_stubs[1];
    481 };
    482 
    483 struct modctl_list {
    484 	struct modctl_list *modl_next;
    485 	struct modctl *modl_modp;
    486 };
    487 
    488 /*
    489  * Structure to manage a loadable module.
    490  * Note: the module (mod_mp) structure's "text" and "text_size" information
    491  * are replicated in the modctl structure so that mod_containing_pc()
    492  * doesn't have to grab any locks (modctls are persistent; modules are not.)
    493  */
    494 typedef struct modctl {
    495 	struct modctl	*mod_next;	/* &modules based list */
    496 	struct modctl	*mod_prev;
    497 	int		mod_id;
    498 	void		*mod_mp;
    499 	kthread_t	*mod_inprogress_thread;
    500 	struct mod_modinfo *mod_modinfo;
    501 	struct modlinkage *mod_linkage;
    502 	char		*mod_filename;
    503 	char		*mod_modname;
    504 
    505 	char		mod_busy;	/* inprogress_thread has locked */
    506 	char		mod_want;	/* someone waiting for unlock */
    507 	char		mod_prim;	/* primary module */
    508 
    509 	int		mod_ref;	/* ref count - from dependent or stub */
    510 
    511 	char		mod_loaded;	/* module in memory */
    512 	char		mod_installed;	/* post _init pre _fini */
    513 	char		mod_loadflags;
    514 	char		mod_delay_unload;	/* deferred unload */
    515 
    516 	struct modctl_list *mod_requisites;	/* mods this one depends on. */
    517 	void		*__unused;	/* NOTE: reuse (same size) is OK, */
    518 					/* deletion causes mdb.vs.core issues */
    519 	int		mod_loadcnt;	/* number of times mod was loaded */
    520 	int		mod_nenabled;	/* # of enabled DTrace probes in mod */
    521 	char		*mod_text;
    522 	size_t		mod_text_size;
    523 
    524 	int		mod_gencount;	/* # times loaded/unloaded */
    525 	struct modctl	*mod_requisite_loading;	/* mod circular dependency */
    526 } modctl_t;
    527 
    528 /*
    529  * mod_loadflags
    530  */
    531 
    532 #define	MOD_NOAUTOUNLOAD	0x1	/* Auto mod-unloader skips this mod */
    533 #define	MOD_NONOTIFY		0x2	/* No krtld notifications on (un)load */
    534 #define	MOD_NOUNLOAD		0x4	/* Assume EBUSY for all _fini's */
    535 
    536 
    537 #ifdef _KERNEL
    538 
    539 #define	MOD_BIND_HASHSIZE	64
    540 #define	MOD_BIND_HASHMASK	(MOD_BIND_HASHSIZE-1)
    541 
    542 typedef int modid_t;
    543 
    544 /*
    545  * global function and data declarations
    546  */
    547 extern kmutex_t mod_lock;
    548 
    549 extern char *systemfile;
    550 extern char **syscallnames;
    551 extern int moddebug;
    552 
    553 /*
    554  * this is the head of a doubly linked list.  Only the next and prev
    555  * pointers are used
    556  */
    557 extern modctl_t modules;
    558 
    559 extern int modload_qualified(const char *,
    560     const char *, const char *, const char *, uint_t[], int, int *);
    561 
    562 extern void	mod_setup(void);
    563 extern int	modload(const char *, const char *);
    564 extern int	modloadonly(const char *, const char *);
    565 extern int	modunload(int);
    566 extern int	mod_hold_stub(struct mod_stub_info *);
    567 extern void	modunload_disable(void);
    568 extern void	modunload_enable(void);
    569 extern void	modunload_begin(void);
    570 extern void	modunload_end(void);
    571 extern int	mod_remove_by_name(char *);
    572 extern int	mod_sysvar(const char *, const char *, u_longlong_t *);
    573 extern int	mod_sysctl(int, void *);
    574 struct sysparam;
    575 extern int	mod_hold_by_modctl(modctl_t *, int);
    576 #define		MOD_WAIT_ONCE		0x01
    577 #define		MOD_WAIT_FOREVER	0x02
    578 #define		MOD_LOCK_HELD		0x04
    579 #define		MOD_LOCK_NOT_HELD	0x08
    580 extern int	mod_sysctl_type(int, int (*)(struct sysparam *, void *),
    581     void *);
    582 extern void	mod_read_system_file(int);
    583 extern void	mod_release_stub(struct mod_stub_info *);
    584 extern void	mod_askparams(void);
    585 extern void	mod_uninstall_daemon(void);
    586 extern void	modreap(void);
    587 extern modctl_t *mod_hold_by_id(modid_t);
    588 extern modctl_t *mod_hold_by_name(const char *);
    589 extern void	mod_release_mod(modctl_t *);
    590 extern uintptr_t modlookup(const char *, const char *);
    591 extern uintptr_t modlookup_by_modctl(modctl_t *, const char *);
    592 extern char	*modgetsymname(uintptr_t, unsigned long *);
    593 extern void	mod_release_requisites(modctl_t *);
    594 extern modctl_t *mod_load_requisite(modctl_t *, char *);
    595 extern modctl_t *mod_find_by_filename(char *, char *);
    596 extern uintptr_t	modgetsymvalue(char *, int);
    597 
    598 extern int	driver_installed(major_t);
    599 extern void	mod_rele_dev_by_major(major_t);
    600 extern struct dev_ops *mod_hold_dev_by_major(major_t);
    601 extern struct dev_ops *mod_hold_dev_by_devi(dev_info_t *);
    602 extern void	mod_rele_dev_by_devi(dev_info_t *);
    603 
    604 extern int make_devname(char *, major_t, int);
    605 extern int gmatch(const char *, const char *);
    606 
    607 extern void make_aliases(struct bind **);
    608 extern int read_binding_file(char *, struct bind **,
    609     int (*line_parser)(char *, int, char *, struct bind **));
    610 extern void clear_binding_hash(struct bind **);
    611 
    612 extern void read_class_file(void);
    613 extern void setbootpath(char *);
    614 extern void setbootfstype(char *);
    615 
    616 extern int install_stubs_by_name(modctl_t *, char *);
    617 extern void install_stubs(modctl_t *);
    618 extern void uninstall_stubs(modctl_t *);
    619 extern void reset_stubs(modctl_t *);
    620 extern modctl_t *mod_getctl(struct modlinkage *);
    621 extern major_t mod_name_to_major(char *);
    622 extern modid_t mod_name_to_modid(char *);
    623 extern char *mod_major_to_name(major_t);
    624 extern void init_devnamesp(int);
    625 extern void init_syscallnames(int);
    626 
    627 extern char *mod_getsysname(int);
    628 extern int mod_getsysnum(char *);
    629 
    630 extern char *mod_containing_pc(caddr_t);
    631 extern int mod_in_autounload(void);
    632 extern const char *mod_modname(struct modlinkage *);
    633 
    634 extern int dev_minorperm(dev_info_t *, char *, mperm_t *);
    635 extern void dev_devices_cleanup(void);
    636 
    637 /*
    638  * Declarations used for dynamic linking support routines.  Interfaces
    639  * are marked with the pragma "unknown_control_flow" to prevent tail call
    640  * optimization, so that implementations can reliably use caller() to
    641  * determine initiating module.
    642  */
    643 #define	KRTLD_MODE_FIRST	0x0001
    644 typedef	struct __ddi_modhandle	*ddi_modhandle_t;
    645 extern ddi_modhandle_t		ddi_modopen(const char *,
    646 				    int, int *);
    647 extern void			*ddi_modsym(ddi_modhandle_t,
    648 				    const char *, int *);
    649 extern int			ddi_modclose(ddi_modhandle_t);
    650 #pragma	unknown_control_flow(ddi_modopen, ddi_modsym, ddi_modclose)
    651 
    652 /*
    653  * Only the following are part of the DDI/DKI
    654  */
    655 extern int	_init(void);
    656 extern int	_fini(void);
    657 extern int	_info(struct modinfo *);
    658 extern int	mod_install(struct modlinkage *);
    659 extern int	mod_remove(struct modlinkage *);
    660 extern int	mod_info(struct modlinkage *, struct modinfo *);
    661 
    662 #else	/* _KERNEL */
    663 
    664 extern int modctl(int, ...);
    665 
    666 #endif	/* _KERNEL */
    667 
    668 /*
    669  * bit definitions for moddebug.
    670  */
    671 #define	MODDEBUG_LOADMSG	0x80000000	/* print "[un]loading..." msg */
    672 #define	MODDEBUG_ERRMSG		0x40000000	/* print detailed error msgs */
    673 #define	MODDEBUG_LOADMSG2	0x20000000	/* print 2nd level msgs */
    674 #define	MODDEBUG_RETIRE		0x10000000	/* print retire msgs */
    675 #define	MODDEBUG_BINDING	0x00040000	/* driver/alias binding */
    676 #define	MODDEBUG_FINI_EBUSY	0x00020000	/* pretend fini returns EBUSY */
    677 #define	MODDEBUG_NOAUL_IPP	0x00010000	/* no Autounloading ipp mods */
    678 #define	MODDEBUG_NOAUL_DACF	0x00008000	/* no Autounloading dacf mods */
    679 #define	MODDEBUG_KEEPTEXT	0x00004000	/* keep text after unloading */
    680 #define	MODDEBUG_NOAUL_DRV	0x00001000	/* no Autounloading Drivers */
    681 #define	MODDEBUG_NOAUL_EXEC	0x00000800	/* no Autounloading Execs */
    682 #define	MODDEBUG_NOAUL_FS	0x00000400	/* no Autounloading File sys */
    683 #define	MODDEBUG_NOAUL_MISC	0x00000200	/* no Autounloading misc */
    684 #define	MODDEBUG_NOAUL_SCHED	0x00000100	/* no Autounloading scheds */
    685 #define	MODDEBUG_NOAUL_STR	0x00000080	/* no Autounloading streams */
    686 #define	MODDEBUG_NOAUL_SYS	0x00000040	/* no Autounloading syscalls */
    687 #define	MODDEBUG_NOCTF		0x00000020	/* do not load CTF debug data */
    688 #define	MODDEBUG_NOAUTOUNLOAD	0x00000010	/* no autounloading at all */
    689 #define	MODDEBUG_DDI_MOD	0x00000008	/* ddi_mod{open,sym,close} */
    690 #define	MODDEBUG_MP_MATCH	0x00000004	/* dev_minorperm */
    691 #define	MODDEBUG_MINORPERM	0x00000002	/* minor perm modctls */
    692 #define	MODDEBUG_USERDEBUG	0x00000001	/* bpt after init_module() */
    693 
    694 #ifdef	__cplusplus
    695 }
    696 #endif
    697 
    698 #endif	/* _SYS_MODCTL_H */
    699