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_SUNNDI_H 27 #define _SYS_SUNNDI_H 28 29 /* 30 * Sun Specific NDI definitions 31 */ 32 33 #include <sys/esunddi.h> 34 #include <sys/sunddi.h> 35 #include <sys/obpdefs.h> 36 37 #ifdef __cplusplus 38 extern "C" { 39 #endif 40 41 #ifdef _KERNEL 42 43 #define NDI_SUCCESS DDI_SUCCESS /* successful return */ 44 #define NDI_FAILURE DDI_FAILURE /* unsuccessful return */ 45 #define NDI_NOMEM -2 /* failed to allocate resources */ 46 #define NDI_BADHANDLE -3 /* bad handle passed to in function */ 47 #define NDI_FAULT -4 /* fault during copyin/copyout */ 48 #define NDI_BUSY -5 /* device busy - could not offline */ 49 #define NDI_UNBOUND -6 /* device not bound to a driver */ 50 51 /* 52 * Property functions: See also, ddipropdefs.h. 53 * In general, the underlying driver MUST be held 54 * to call it's property functions. 55 */ 56 57 /* 58 * Used to create boolean properties 59 */ 60 int 61 ndi_prop_create_boolean(dev_t match_dev, dev_info_t *dip, char *name); 62 63 /* 64 * Used to create, modify, and lookup integer properties 65 */ 66 int 67 ndi_prop_update_int(dev_t match_dev, dev_info_t *dip, char *name, int data); 68 69 int 70 ndi_prop_update_int_array(dev_t match_dev, dev_info_t *dip, char *name, 71 int *data, uint_t nelements); 72 73 int 74 ndi_prop_update_int64(dev_t match_dev, dev_info_t *dip, char *name, 75 int64_t data); 76 77 int 78 ndi_prop_update_int64_array(dev_t match_dev, dev_info_t *dip, char *name, 79 int64_t *data, uint_t nelements); 80 81 /* 82 * Used to create, modify, and lookup string properties 83 */ 84 int 85 ndi_prop_update_string(dev_t match_dev, dev_info_t *dip, char *name, 86 char *data); 87 88 int 89 ndi_prop_update_string_array(dev_t match_dev, dev_info_t *dip, 90 char *name, char **data, uint_t nelements); 91 92 /* 93 * Used to create, modify, and lookup byte properties 94 */ 95 int 96 ndi_prop_update_byte_array(dev_t match_dev, dev_info_t *dip, 97 char *name, uchar_t *data, uint_t nelements); 98 99 /* 100 * Used to remove properties 101 */ 102 int 103 ndi_prop_remove(dev_t dev, dev_info_t *dip, char *name); 104 105 void 106 ndi_prop_remove_all(dev_info_t *dip); 107 108 /* 109 * Nexus Driver Functions 110 */ 111 /* 112 * Allocate and initialize a new dev_info structure. 113 * This routine will often be called at interrupt time by a nexus in 114 * response to a hotplug event, therefore memory allocations are 115 * not allowed to sleep. 116 */ 117 int 118 ndi_devi_alloc(dev_info_t *parent, char *node_name, pnode_t nodeid, 119 dev_info_t **ret_dip); 120 121 void 122 ndi_devi_alloc_sleep(dev_info_t *parent, char *node_name, pnode_t nodeid, 123 dev_info_t **ret_dip); 124 125 /* 126 * Remove an initialized (but not yet attached) dev_info 127 * node from it's parent. 128 */ 129 int 130 ndi_devi_free(dev_info_t *dip); 131 132 /* devinfo locking: use DEVI_BUSY_OWNED in ASSERTs to verify */ 133 void ndi_devi_enter(dev_info_t *dip, int *circ); 134 void ndi_devi_exit(dev_info_t *dip, int circ); 135 int ndi_devi_tryenter(dev_info_t *dip, int *circ); 136 137 /* devinfo ref counting */ 138 void ndi_hold_devi(dev_info_t *dip); 139 void ndi_rele_devi(dev_info_t *dip); 140 141 /* driver ref counting */ 142 struct dev_ops *ndi_hold_driver(dev_info_t *dip); 143 void ndi_rele_driver(dev_info_t *dip); 144 145 /* 146 * Change the node name 147 */ 148 int 149 ndi_devi_set_nodename(dev_info_t *dip, char *name, int flags); 150 151 /* 152 * Place the devinfo in the DS_BOUND state, 153 * binding a driver to the device 154 * 155 * Flags: 156 * all flags are ignored. 157 */ 158 int 159 ndi_devi_bind_driver(dev_info_t *dip, uint_t flags); 160 161 /* 162 * Asynchronous version of ndi_devi_bind_driver, callable from 163 * interrupt context. The dip must be a persistent node. 164 */ 165 int 166 ndi_devi_bind_driver_async(dev_info_t *dip, uint_t flags); 167 168 /* 169 * Return devctl state of the child addressed by "name@addr". 170 * For use by a driver's DEVCTL_DEVICE_GETSTATE handler. 171 */ 172 int 173 ndi_devctl_device_getstate(dev_info_t *parent, struct devctl_iocdata *dcp, 174 uint_t *state); 175 176 /* 177 * Transition the child addressed by "name@addr" to the online state. 178 * For use by a driver's DEVCTL_DEVICE_ONLINE handler. 179 */ 180 int 181 ndi_devctl_device_online(dev_info_t *dip, struct devctl_iocdata *dcp, 182 uint_t flags); 183 184 /* 185 * Transition the child addressed by "name@addr" to the offline state. 186 * For use by a driver's DEVCTL_DEVICE_OFFLINE handler. 187 */ 188 int 189 ndi_devctl_device_offline(dev_info_t *dip, struct devctl_iocdata *dcp, 190 uint_t flags); 191 192 /* 193 * Remove the child addressed by name@addr. 194 * For use by a driver's DEVCTL_DEVICE_REMOVE handler. 195 */ 196 int 197 ndi_devctl_device_remove(dev_info_t *dip, struct devctl_iocdata *dcp, 198 uint_t flags); 199 200 /* 201 * Bus get state 202 * For use by a driver's DEVCTL_BUS_GETSTATE handler. 203 */ 204 int 205 ndi_devctl_bus_getstate(dev_info_t *dip, struct devctl_iocdata *dcp, 206 uint_t *state); 207 208 /* 209 * Place the devinfo in the ONLINE state 210 */ 211 int 212 ndi_devi_online(dev_info_t *dip, uint_t flags); 213 214 /* 215 * Generic devctl ioctl handler 216 */ 217 int 218 ndi_devctl_ioctl(dev_info_t *dip, int cmd, intptr_t arg, int mode, 219 uint_t flags); 220 221 /* 222 * Asynchronous version of ndi_devi_online, callable from interrupt 223 * context. The dip must be a persistent node. 224 */ 225 int 226 ndi_devi_online_async(dev_info_t *dip, uint_t flags); 227 228 229 /* 230 * Configure children of a nexus node. 231 * 232 * Flags: 233 * NDI_ONLINE_ATTACH - Attach driver to devinfo node when placing 234 * the device Online. 235 * NDI_CONFIG - Recursively configure children if child is nexus node 236 */ 237 int 238 ndi_devi_config(dev_info_t *dip, int flags); 239 240 int 241 ndi_devi_config_driver(dev_info_t *dip, int flags, major_t major); 242 243 int 244 ndi_devi_config_one(dev_info_t *dip, char *devnm, dev_info_t **dipp, int flags); 245 246 /* 247 * Unconfigure children of a nexus node. 248 * 249 * Flags: 250 * NDI_DEVI_REMOVE - Remove child devinfo nodes 251 * 252 * NDI_UNCONFIG - Put child devinfo nodes to uninitialized state, 253 * release resources held by child nodes. 254 */ 255 int 256 ndi_devi_unconfig(dev_info_t *dip, int flags); 257 258 int 259 e_ddi_devi_unconfig(dev_info_t *dip, dev_info_t **dipp, int flags); 260 261 int 262 ndi_devi_unconfig_one(dev_info_t *dip, char *devnm, dev_info_t **dipp, 263 int flags); 264 265 int 266 ndi_devi_unconfig_driver(dev_info_t *dip, int flags, major_t major); 267 268 void 269 ndi_set_bus_private(dev_info_t *dip, boolean_t up, uint32_t port_type, 270 void *data); 271 272 void * 273 ndi_get_bus_private(dev_info_t *dip, boolean_t up); 274 275 boolean_t 276 ndi_port_type(dev_info_t *dip, boolean_t up, uint32_t port_type); 277 278 /* 279 * Create/Destroy Interrupt Resource Management (IRM) Pools. 280 */ 281 int 282 ndi_irm_create(dev_info_t *dip, ddi_irm_params_t *paramsp, 283 ddi_irm_pool_t **pool_retp); 284 285 int 286 ndi_irm_destroy(ddi_irm_pool_t *poolp); 287 288 /* 289 * Take a device node "Offline". 290 * 291 * Offline means to detach the device instance from the bound 292 * driver and setting the devinfo state to prevent deferred attach 293 * from re-attaching the device instance. 294 * 295 * Flags: 296 * NDI_DEVI_REMOVE - Remove the node from the devinfo tree after 297 * first taking it Offline. 298 */ 299 300 #define NDI_DEVI_REMOVE 0x00000001 /* remove after unconfig */ 301 #define NDI_ONLINE_ATTACH 0x00000002 /* online/attach after config */ 302 #define NDI_MDI_FALLBACK 0x00000004 /* Leadville to fallback to phci */ 303 #define NDI_CONFIG 0x00000008 /* recursively config descendants */ 304 #define NDI_UNCONFIG 0x00000010 /* unconfig to uninitialized state */ 305 #define NDI_DEVI_BIND 0x00000020 /* transition to DS_BOUND state */ 306 #define NDI_DEVI_PERSIST 0x00000040 /* do not config offlined nodes */ 307 #define NDI_PROMNAME 0x00000080 /* name comes from prom */ 308 #define NDI_DEVFS_CLEAN 0x00001000 /* clean dv_nodes only, no detach */ 309 #define NDI_AUTODETACH 0x00002000 /* moduninstall daemon */ 310 #define NDI_NO_EVENT 0x00004000 /* don't devfs add/remove events */ 311 #define NDI_DEVI_DEBUG 0x00008000 /* turn on observability */ 312 #define NDI_CONFIG_REPROBE 0x00010000 /* force reprobe (deferred attach) */ 313 #define NDI_DEVI_ONLINE 0x00020000 /* force offlined device to online */ 314 #define NDI_DEVI_OFFLINE 0x00040000 /* set detached device to offline */ 315 #define NDI_POST_EVENT 0x00080000 /* Post NDI events before remove */ 316 #define NDI_BRANCH_EVENT_OP 0x01000000 /* branch op needs branch event */ 317 #define NDI_NO_EVENT_STATE_CHNG 0x02000000 /* don't change the event state */ 318 #define NDI_DRV_CONF_REPROBE 0x04000000 /* reprobe conf-enum'd nodes only */ 319 #define NDI_DETACH_DRIVER 0x08000000 /* performing driver_detach */ 320 #define NDI_MTC_OFF 0x10000000 /* disable multi-threading */ 321 322 /* ndi interface flag values */ 323 #define NDI_SLEEP 0x000000 324 #define NDI_NOSLEEP 0x100000 325 #define NDI_EVENT_NOPASS 0x200000 /* do not pass event req up the tree */ 326 327 int 328 ndi_devi_offline(dev_info_t *dip, uint_t flags); 329 330 /* 331 * Find the child dev_info node of parent nexus 'p' whose name 332 * matches "cname"@"caddr". Use ndi_devi_findchild() instead. 333 */ 334 dev_info_t * 335 ndi_devi_find(dev_info_t *p, char *cname, char *caddr); 336 337 /* 338 * Find the child dev_info node of parent nexus 'p' whose name 339 * matches device name "name"@"addr". 340 */ 341 dev_info_t * 342 ndi_devi_findchild(dev_info_t *p, char *devname); 343 344 /* 345 * generate debug msg via NDI_DEVI_DEBUG flag 346 */ 347 #define NDI_DEBUG(flags, args) \ 348 if (flags & NDI_DEVI_DEBUG) cmn_err args 349 350 /* 351 * Copy in the devctl IOCTL data structure and the strings referenced 352 * by the structure. 353 * 354 * Convenience functions for use by nexus drivers as part of the 355 * implementation of devctl IOCTL handling. 356 */ 357 int 358 ndi_dc_allochdl(void *iocarg, struct devctl_iocdata **rdcp); 359 360 void 361 ndi_dc_freehdl(struct devctl_iocdata *dcp); 362 363 char * 364 ndi_dc_getpath(struct devctl_iocdata *dcp); 365 366 char * 367 ndi_dc_getname(struct devctl_iocdata *dcp); 368 369 char * 370 ndi_dc_getaddr(struct devctl_iocdata *dcp); 371 372 nvlist_t * 373 ndi_dc_get_ap_data(struct devctl_iocdata *dcp); 374 375 char * 376 ndi_dc_getminorname(struct devctl_iocdata *dcp); 377 378 int 379 ndi_dc_return_dev_state(dev_info_t *dip, struct devctl_iocdata *dcp); 380 381 int 382 ndi_dc_return_ap_state(devctl_ap_state_t *ap, struct devctl_iocdata *dcp); 383 384 int 385 ndi_dc_return_bus_state(dev_info_t *dip, struct devctl_iocdata *dcp); 386 387 int 388 ndi_dc_devi_create(struct devctl_iocdata *dcp, dev_info_t *pdip, int flags, 389 dev_info_t **rdip); 390 391 int 392 ndi_get_bus_state(dev_info_t *dip, uint_t *rstate); 393 394 int 395 ndi_set_bus_state(dev_info_t *dip, uint_t state); 396 397 /* 398 * Post an event notification up the device tree hierarchy to the 399 * parent nexus, until claimed by a bus nexus driver or the top 400 * of the dev_info tree is reached. 401 */ 402 int 403 ndi_post_event(dev_info_t *dip, dev_info_t *rdip, ddi_eventcookie_t eventhdl, 404 void *impl_data); 405 406 /* 407 * Called by the NDI Event Framework to deliver a registration request to the 408 * appropriate bus nexus driver. 409 */ 410 int 411 ndi_busop_add_eventcall(dev_info_t *dip, dev_info_t *rdip, 412 ddi_eventcookie_t eventhdl, void (*callback)(), void *arg, 413 ddi_callback_id_t *cb_id); 414 415 /* 416 * Called by the NDI Event Framework to deliver an unregister request to the 417 * appropriate bus nexus driver. 418 */ 419 int 420 ndi_busop_remove_eventcall(dev_info_t *ddip, ddi_callback_id_t id); 421 422 /* 423 * Called by the NDI Event Framework and/or a bus nexus driver's 424 * implementation of the (*bus_get_eventcookie)() interface up the device tree 425 * hierarchy, until claimed by a bus nexus driver or the top of the dev_info 426 * tree is reached. The NDI Event Framework will skip nexus drivers which are 427 * not configured to handle NDI events. 428 */ 429 int 430 ndi_busop_get_eventcookie(dev_info_t *dip, dev_info_t *rdip, char *name, 431 ddi_eventcookie_t *event_cookiep); 432 433 /* 434 * ndi event callback support routines: 435 * 436 * these functions require an opaque ndi event handle 437 */ 438 typedef struct ndi_event_hdl *ndi_event_hdl_t; 439 440 /* 441 * structure for maintaining each registered callback 442 */ 443 typedef struct ndi_event_callbacks { 444 struct ndi_event_callbacks *ndi_evtcb_next; 445 struct ndi_event_callbacks *ndi_evtcb_prev; 446 dev_info_t *ndi_evtcb_dip; 447 char *devname; /* name of device defining this callback */ 448 void (*ndi_evtcb_callback)(); 449 void *ndi_evtcb_arg; 450 ddi_eventcookie_t ndi_evtcb_cookie; 451 } ndi_event_callbacks_t; 452 453 /* 454 * a nexus driver defines events that it can support using the 455 * following structure 456 */ 457 typedef struct ndi_event_definition { 458 int ndi_event_tag; 459 char *ndi_event_name; 460 ddi_plevel_t ndi_event_plevel; 461 uint_t ndi_event_attributes; 462 } ndi_event_definition_t; 463 464 typedef struct ndi_event_cookie { 465 ndi_event_definition_t *definition; /* Event Description */ 466 dev_info_t *ddip; /* Devi defining this event */ 467 ndi_event_callbacks_t *callback_list; /* Cb's reg'd to w/ this evt */ 468 struct ndi_event_cookie *next_cookie; /* Next cookie def'd in hdl */ 469 } ndi_event_cookie_t; 470 471 472 #define NDI_EVENT(cookie) ((struct ndi_event_cookie *)(void *)(cookie)) 473 #define NDI_EVENT_NAME(cookie) (NDI_EVENT(cookie)->definition->ndi_event_name) 474 #define NDI_EVENT_TAG(cookie) (NDI_EVENT(cookie)->definition->ndi_event_tag) 475 #define NDI_EVENT_ATTRIBUTES(cookie) \ 476 (NDI_EVENT(cookie)->definition->ndi_event_attributes) 477 #define NDI_EVENT_PLEVEL(cookie) \ 478 (NDI_EVENT(cookie)->definition->ndi_event_plevel) 479 #define NDI_EVENT_DDIP(cookie) (NDI_EVENT(cookie)->ddip) 480 481 /* ndi_event_attributes */ 482 #define NDI_EVENT_POST_TO_ALL 0x0 /* broadcast: post to all handlers */ 483 #define NDI_EVENT_POST_TO_TGT 0x1 /* call only specific child's hdlr */ 484 485 typedef struct ndi_event_set { 486 ushort_t ndi_events_version; 487 ushort_t ndi_n_events; 488 ndi_event_definition_t *ndi_event_defs; 489 } ndi_event_set_t; 490 491 492 #define NDI_EVENTS_REV0 0 493 #define NDI_EVENTS_REV1 1 494 495 /* 496 * allocate an ndi event handle 497 */ 498 int 499 ndi_event_alloc_hdl(dev_info_t *dip, ddi_iblock_cookie_t cookie, 500 ndi_event_hdl_t *ndi_event_hdl, uint_t flag); 501 502 /* 503 * free the ndi event handle 504 */ 505 int 506 ndi_event_free_hdl(ndi_event_hdl_t handle); 507 508 /* 509 * bind or unbind a set of events to/from the event handle 510 */ 511 int 512 ndi_event_bind_set(ndi_event_hdl_t handle, 513 ndi_event_set_t *ndi_event_set, 514 uint_t flag); 515 516 int 517 ndi_event_unbind_set(ndi_event_hdl_t handle, 518 ndi_event_set_t *ndi_event_set, 519 uint_t flag); 520 521 /* 522 * get an event cookie 523 */ 524 int 525 ndi_event_retrieve_cookie(ndi_event_hdl_t handle, 526 dev_info_t *child_dip, 527 char *eventname, 528 ddi_eventcookie_t *cookiep, 529 uint_t flag); 530 531 /* 532 * add an event callback info to the ndi event handle 533 */ 534 int 535 ndi_event_add_callback(ndi_event_hdl_t handle, 536 dev_info_t *child_dip, 537 ddi_eventcookie_t cookie, 538 void (*event_callback) 539 (dev_info_t *, 540 ddi_eventcookie_t, 541 void *arg, 542 void *impldata), 543 void *arg, 544 uint_t flag, 545 ddi_callback_id_t *cb_id); 546 547 /* 548 * remove an event callback registration from the ndi event handle 549 */ 550 int 551 ndi_event_remove_callback(ndi_event_hdl_t handle, ddi_callback_id_t id); 552 553 /* 554 * perform callbacks for a specified cookie 555 */ 556 int 557 ndi_event_run_callbacks(ndi_event_hdl_t handle, dev_info_t *child_dip, 558 ddi_eventcookie_t cookie, void *bus_impldata); 559 560 /* 561 * do callback for just one child_dip, regardless of attributes 562 */ 563 int ndi_event_do_callback(ndi_event_hdl_t handle, dev_info_t *child_dip, 564 ddi_eventcookie_t cookie, void *bus_impldata); 565 566 /* 567 * ndi_event_tag_to_cookie: utility function to find an event cookie 568 * given an event tag 569 */ 570 ddi_eventcookie_t 571 ndi_event_tag_to_cookie(ndi_event_hdl_t handle, int event_tag); 572 573 /* 574 * ndi_event_cookie_to_tag: utility function to find an event tag 575 * given an event_cookie 576 */ 577 int 578 ndi_event_cookie_to_tag(ndi_event_hdl_t handle, 579 ddi_eventcookie_t cookie); 580 581 /* 582 * ndi_event_cookie_to_name: utility function to find an event 583 * name given an event_cookie 584 */ 585 char * 586 ndi_event_cookie_to_name(ndi_event_hdl_t handle, 587 ddi_eventcookie_t cookie); 588 589 /* 590 * ndi_event_tag_to_name: utility function to find an event 591 * name given an event_tag 592 */ 593 char * 594 ndi_event_tag_to_name(ndi_event_hdl_t handle, int event_tag); 595 596 dev_info_t * 597 ndi_devi_config_vhci(char *, int); 598 599 #ifdef DEBUG 600 /* 601 * ndi_event_dump_hdl: debug functionality used to display event handle 602 */ 603 void 604 ndi_event_dump_hdl(struct ndi_event_hdl *hdl, char *location); 605 #endif 606 607 /* 608 * Default busop bus_config helper functions 609 */ 610 int 611 ndi_busop_bus_config(dev_info_t *pdip, uint_t flags, ddi_bus_config_op_t op, 612 void *arg, dev_info_t **child, clock_t reset_delay); 613 614 int 615 ndi_busop_bus_unconfig(dev_info_t *dip, uint_t flags, ddi_bus_config_op_t op, 616 void *arg); 617 618 619 /* 620 * Bus Resource allocation structures and function prototypes exported 621 * by busra module 622 */ 623 624 /* structure for specifying a request */ 625 typedef struct ndi_ra_request { 626 uint_t ra_flags; /* General flags */ 627 /* see bit definitions below */ 628 629 uint64_t ra_len; /* Requested allocation length */ 630 631 uint64_t ra_addr; /* Specific base address requested */ 632 633 uint64_t ra_boundbase; /* Base address of the area for */ 634 /* the allocated resource to be */ 635 /* restricted to */ 636 637 uint64_t ra_boundlen; /* Length of the area, starting */ 638 /* from ra_boundbase, for the */ 639 /* allocated resource to be */ 640 /* restricted to. */ 641 642 uint64_t ra_align_mask; /* Alignment mask used for */ 643 /* allocated base address */ 644 } ndi_ra_request_t; 645 646 647 /* ra_flags bit definitions */ 648 #define NDI_RA_ALIGN_SIZE 0x0001 /* Set the alignment of the */ 649 /* allocated resource address */ 650 /* according to the ra_len */ 651 /* value (alignment mask will */ 652 /* be (ra_len - 1)). Value of */ 653 /* ra_len has to be power of 2. */ 654 /* If this flag is set, value of */ 655 /* ra_align_mask will be ignored. */ 656 657 658 #define NDI_RA_ALLOC_BOUNDED 0x0002 /* Indicates that the resource */ 659 /* should be restricted to the */ 660 /* area specified by ra_boundbase */ 661 /* and ra_boundlen */ 662 663 #define NDI_RA_ALLOC_SPECIFIED 0x0004 /* Indicates that a specific */ 664 /* address (ra_addr value) is */ 665 /* requested. */ 666 667 #define NDI_RA_ALLOC_PARTIAL_OK 0x0008 /* Indicates if requested size */ 668 /* (ra_len) chunk is not available */ 669 /* then allocate as big chunk as */ 670 /* possible which is less than or */ 671 /* equal to ra_len size. */ 672 673 674 /* return values specific to bus resource allocator */ 675 #define NDI_RA_PARTIAL_REQ -7 676 677 678 679 680 /* Predefined types for generic type of resources */ 681 #define NDI_RA_TYPE_MEM "memory" 682 #define NDI_RA_TYPE_IO "io" 683 #define NDI_RA_TYPE_PCI_BUSNUM "pci_bus_number" 684 #define NDI_RA_TYPE_PCI_PREFETCH_MEM "pci_prefetchable_memory" 685 #define NDI_RA_TYPE_INTR "interrupt" 686 687 688 689 /* flag bit definition */ 690 #define NDI_RA_PASS 0x0001 /* pass request up the dev tree */ 691 692 693 /* 694 * Prototype definitions for functions exported 695 */ 696 697 int 698 ndi_ra_map_setup(dev_info_t *dip, char *type); 699 700 int 701 ndi_ra_map_destroy(dev_info_t *dip, char *type); 702 703 int 704 ndi_ra_alloc(dev_info_t *dip, ndi_ra_request_t *req, uint64_t *basep, 705 uint64_t *lenp, char *type, uint_t flag); 706 707 int 708 ndi_ra_free(dev_info_t *dip, uint64_t base, uint64_t len, char *type, 709 uint_t flag); 710 711 712 /* 713 * ndi_dev_is_prom_node: Return non-zero if the node is a prom node 714 */ 715 int ndi_dev_is_prom_node(dev_info_t *); 716 717 /* 718 * ndi_dev_is_pseudo_node: Return non-zero if the node is a pseudo node. 719 * NB: all non-prom nodes are pseudo nodes. 720 * c.f. ndi_dev_is_persistent_node 721 */ 722 int ndi_dev_is_pseudo_node(dev_info_t *); 723 724 /* 725 * ndi_dev_is_persistent_node: Return non-zero if the node has the 726 * property of persistence. 727 */ 728 int ndi_dev_is_persistent_node(dev_info_t *); 729 730 /* 731 * ndi_dev_is_hidden_node: Return non-zero if the node is hidden. 732 */ 733 int ndi_dev_is_hidden_node(dev_info_t *); 734 735 /* 736 * ndi_devi_set_hidden: mark a node as hidden 737 * ndi_devi_clr_hidden: mark a node as visible 738 */ 739 void ndi_devi_set_hidden(dev_info_t *); 740 void ndi_devi_clr_hidden(dev_info_t *); 741 742 /* 743 * Event posted when a fault is reported 744 */ 745 #define DDI_DEVI_FAULT_EVENT "DDI:DEVI_FAULT" 746 747 struct ddi_fault_event_data { 748 dev_info_t *f_dip; 749 ddi_fault_impact_t f_impact; 750 ddi_fault_location_t f_location; 751 const char *f_message; 752 ddi_devstate_t f_oldstate; 753 }; 754 755 /* 756 * Access handle/DMA handle fault flag setting/clearing functions for nexi 757 */ 758 void ndi_set_acc_fault(ddi_acc_handle_t ah); 759 void ndi_clr_acc_fault(ddi_acc_handle_t ah); 760 void ndi_set_dma_fault(ddi_dma_handle_t dh); 761 void ndi_clr_dma_fault(ddi_dma_handle_t dh); 762 763 /* Driver.conf property merging */ 764 int ndi_merge_node(dev_info_t *, int (*)(dev_info_t *, char *, int)); 765 void ndi_merge_wildcard_node(dev_info_t *); 766 767 /* 768 * Ndi 'flavor' support: These interfaces are to support a nexus driver 769 * with multiple 'flavors' of children (devi_flavor of child), coupled 770 * with a child flavor-specifc private data mechanism (via devi_flavor_v 771 * of parent). This is provided as an extension to ddi_[sg]et_driver_private, 772 * where the vanilla 'flavor' is what is stored or retrieved via 773 * ddi_[sg]et_driver_private. 774 * 775 * Flavors are indexed with a small integer. The first flavor, flavor 776 * zero, is always present and reserved as the 'vanilla' flavor. 777 * Space for extra flavors can be allocated and private pointers 778 * with respect to each flavor set and retrieved. 779 * 780 * NOTE:For a nexus driver, if the need to support multiple flavors of 781 * children is understood from the begining, then a private 'flavor' 782 * mechanism can be implemented via ddi_[sg]et_driver_private. 783 * 784 * With SCSA, the need to support multiple flavors of children was not 785 * anticipated, and ddi_get_driver_private(9F) of an initiator port 786 * devinfo node was publicly defined in the DDI to return a 787 * scsi_device(9S) child-flavor specific value: a pointer to 788 * scsi_hba_tran(9S). Over the years, each time the need to support 789 * a new flavor of child has occurred, a new form of overload/kludge 790 * has been devised. The ndi 'flavors' interfaces provide a simple way 791 * to address this issue that can be used by both SCSA nexus support, 792 * and by other nexus drivers. 793 */ 794 795 /* 796 * Interfaces to maintain flavor-specific private data for children of self 797 */ 798 #define NDI_FLAVOR_VANILLA 0 799 800 void ndi_flavorv_alloc(dev_info_t *self, int nflavors); 801 void ndi_flavorv_set(dev_info_t *self, ndi_flavor_t child_flavor, void *); 802 void *ndi_flavorv_get(dev_info_t *self, ndi_flavor_t child_flavor); 803 804 /* Interfaces for 'self' nexus driver to get/set flavor of child */ 805 void ndi_flavor_set(dev_info_t *child, ndi_flavor_t child_flavor); 806 ndi_flavor_t ndi_flavor_get(dev_info_t *child); 807 808 #endif /* _KERNEL */ 809 810 #ifdef __cplusplus 811 } 812 #endif 813 814 #endif /* _SYS_SUNNDI_H */ 815