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 2013 Nexenta Systems, Inc.  All rights reserved.
  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            *mod_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 volatile 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      major_valid(major_t);
 599 extern int      driver_installed(major_t);
 600 extern int      driver_active(major_t);
 601 
 602 extern void     mod_rele_dev_by_major(major_t);
 603 extern struct dev_ops *mod_hold_dev_by_major(major_t);
 604 extern struct dev_ops *mod_hold_dev_by_devi(dev_info_t *);
 605 extern void     mod_rele_dev_by_devi(dev_info_t *);
 606 
 607 extern int make_devname(char *, major_t, int);
 608 extern int gmatch(const char *, const char *);
 609 
 610 extern void make_aliases(struct bind **);
 611 extern int read_binding_file(char *, struct bind **,
 612     int (*line_parser)(char *, int, char *, struct bind **));
 613 extern void clear_binding_hash(struct bind **);
 614 
 615 extern void read_class_file(void);
 616 extern void setbootpath(char *);
 617 extern void setbootfstype(char *);
 618 
 619 extern int install_stubs_by_name(modctl_t *, char *);
 620 extern void install_stubs(modctl_t *);
 621 extern void uninstall_stubs(modctl_t *);
 622 extern void reset_stubs(modctl_t *);
 623 extern modctl_t *mod_getctl(struct modlinkage *);
 624 extern major_t mod_name_to_major(char *);
 625 extern modid_t mod_name_to_modid(char *);
 626 extern char *mod_major_to_name(major_t);
 627 extern void init_devnamesp(int);
 628 extern void init_syscallnames(int);
 629 
 630 extern char *mod_getsysname(int);
 631 extern int mod_getsysnum(char *);
 632 
 633 extern char *mod_containing_pc(caddr_t);
 634 extern int mod_in_autounload(void);
 635 extern const char *mod_modname(struct modlinkage *);
 636 
 637 extern int dev_minorperm(dev_info_t *, char *, mperm_t *);
 638 extern void dev_devices_cleanup(void);
 639 
 640 /*
 641  * Declarations used for dynamic linking support routines.  Interfaces
 642  * are marked with the pragma "unknown_control_flow" to prevent tail call
 643  * optimization, so that implementations can reliably use caller() to
 644  * determine initiating module.
 645  */
 646 #define KRTLD_MODE_FIRST        0x0001
 647 typedef struct __ddi_modhandle  *ddi_modhandle_t;
 648 extern ddi_modhandle_t          ddi_modopen(const char *,
 649                                     int, int *);
 650 extern void                     *ddi_modsym(ddi_modhandle_t,
 651                                     const char *, int *);
 652 extern int                      ddi_modclose(ddi_modhandle_t);
 653 #pragma unknown_control_flow(ddi_modopen, ddi_modsym, ddi_modclose)
 654 
 655 /*
 656  * Only the following are part of the DDI/DKI
 657  */
 658 extern int      _init(void);
 659 extern int      _fini(void);
 660 extern int      _info(struct modinfo *);
 661 extern int      mod_install(struct modlinkage *);
 662 extern int      mod_remove(struct modlinkage *);
 663 extern int      mod_info(struct modlinkage *, struct modinfo *);
 664 
 665 #else   /* _KERNEL */
 666 
 667 extern int modctl(int, ...);
 668 
 669 #endif  /* _KERNEL */
 670 
 671 /*
 672  * bit definitions for moddebug.
 673  */
 674 #define MODDEBUG_LOADMSG        0x80000000      /* print "[un]loading..." msg */
 675 #define MODDEBUG_ERRMSG         0x40000000      /* print detailed error msgs */
 676 #define MODDEBUG_LOADMSG2       0x20000000      /* print 2nd level msgs */
 677 #define MODDEBUG_RETIRE         0x10000000      /* print retire msgs */
 678 #define MODDEBUG_BINDING        0x00040000      /* driver/alias binding */
 679 #define MODDEBUG_FINI_EBUSY     0x00020000      /* pretend fini returns EBUSY */
 680 #define MODDEBUG_NOAUL_IPP      0x00010000      /* no Autounloading ipp mods */
 681 #define MODDEBUG_NOAUL_DACF     0x00008000      /* no Autounloading dacf mods */
 682 #define MODDEBUG_KEEPTEXT       0x00004000      /* keep text after unloading */
 683 #define MODDEBUG_NOAUL_DRV      0x00001000      /* no Autounloading Drivers */
 684 #define MODDEBUG_NOAUL_EXEC     0x00000800      /* no Autounloading Execs */
 685 #define MODDEBUG_NOAUL_FS       0x00000400      /* no Autounloading File sys */
 686 #define MODDEBUG_NOAUL_MISC     0x00000200      /* no Autounloading misc */
 687 #define MODDEBUG_NOAUL_SCHED    0x00000100      /* no Autounloading scheds */
 688 #define MODDEBUG_NOAUL_STR      0x00000080      /* no Autounloading streams */
 689 #define MODDEBUG_NOAUL_SYS      0x00000040      /* no Autounloading syscalls */
 690 #define MODDEBUG_NOCTF          0x00000020      /* do not load CTF debug data */
 691 #define MODDEBUG_NOAUTOUNLOAD   0x00000010      /* no autounloading at all */
 692 #define MODDEBUG_DDI_MOD        0x00000008      /* ddi_mod{open,sym,close} */
 693 #define MODDEBUG_MP_MATCH       0x00000004      /* dev_minorperm */
 694 #define MODDEBUG_MINORPERM      0x00000002      /* minor perm modctls */
 695 #define MODDEBUG_USERDEBUG      0x00000001      /* bpt after init_module() */
 696 
 697 #ifdef  __cplusplus
 698 }
 699 #endif
 700 
 701 #endif  /* _SYS_MODCTL_H */