/* * CDDL HEADER START * * The contents of this file are subject to the terms of the * Common Development and Distribution License (the "License"). * You may not use this file except in compliance with the License. * * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE * or http://www.opensolaris.org/os/licensing. * See the License for the specific language governing permissions * and limitations under the License. * * When distributing Covered Code, include this CDDL HEADER in each * file and include the License file at usr/src/OPENSOLARIS.LICENSE. * If applicable, add the following below this CDDL HEADER, with the * fields enclosed by brackets "[]" replaced with your own identifying * information: Portions Copyright [yyyy] [name of copyright owner] * * CDDL HEADER END */ /* * Copyright 2008 Sun Microsystems, Inc. All rights reserved. * Use is subject to license terms. */ #ifndef _SYS_DDI_IMPLFUNCS_H #define _SYS_DDI_IMPLFUNCS_H #ifdef __cplusplus extern "C" { #endif #include #include #include #include #include #ifdef _KERNEL /* * Declare implementation functions that sunddi functions can * call in order to perform their required task. Each kernel * architecture must provide them. */ int i_ddi_bus_map(dev_info_t *dip, dev_info_t *rdip, ddi_map_req_t *mp, off_t offset, off_t len, caddr_t *vaddrp); int i_ddi_apply_range(dev_info_t *dip, dev_info_t *rdip, struct regspec *rp); struct regspec * i_ddi_rnumber_to_regspec(dev_info_t *dip, int rnumber); int i_ddi_map_fault(dev_info_t *dip, dev_info_t *rdip, struct hat *hat, struct seg *seg, caddr_t addr, struct devpage *dp, pfn_t pfn, uint_t prot, uint_t lock); ddi_regspec_t i_ddi_get_regspec(dev_info_t *dip, dev_info_t *rdip, uint_t rnumber, off_t offset, off_t len); /* * Implementation specific memory allocation and de-allocation routines. */ int i_ddi_mem_alloc(dev_info_t *dip, ddi_dma_attr_t *attributes, size_t length, int cansleep, int streaming, ddi_device_acc_attr_t *accattrp, caddr_t *kaddrp, size_t *real_length, ddi_acc_hdl_t *handlep); int i_ddi_mem_alloc_lim(dev_info_t *dip, ddi_dma_lim_t *limits, size_t length, int cansleep, int streaming, ddi_device_acc_attr_t *accattrp, caddr_t *kaddrp, uint_t *real_length, ddi_acc_hdl_t *handlep); void i_ddi_mem_free(caddr_t kaddr, ddi_acc_hdl_t *ap); int i_ddi_devi_get_ppa(dev_info_t *dip); void i_ddi_devi_set_ppa(dev_info_t *dip, int ppa); void i_ddi_devacc_to_hatacc(ddi_device_acc_attr_t *devaccp, uint_t *hataccp); void i_ddi_cacheattr_to_hatacc(uint_t flags, uint_t *hataccp); boolean_t i_ddi_check_cache_attr(uint_t flags); /* * Access and DMA handle fault set/clear routines */ void i_ddi_acc_set_fault(ddi_acc_handle_t handle); void i_ddi_acc_clr_fault(ddi_acc_handle_t handle); void i_ddi_dma_set_fault(ddi_dma_handle_t handle); void i_ddi_dma_clr_fault(ddi_dma_handle_t handle); /* * Event-handling functions for rootnex * These provide the standard implementation of fault handling */ void i_ddi_rootnex_init_events(dev_info_t *dip); int i_ddi_rootnex_get_eventcookie(dev_info_t *dip, dev_info_t *rdip, char *eventname, ddi_eventcookie_t *cookiep); int i_ddi_rootnex_add_eventcall(dev_info_t *dip, dev_info_t *rdip, ddi_eventcookie_t eventid, void (*handler)(dev_info_t *dip, ddi_eventcookie_t event, void *arg, void *impl_data), void *arg, ddi_callback_id_t *cb_id); int i_ddi_rootnex_remove_eventcall(dev_info_t *devi, ddi_callback_id_t cb_id); int i_ddi_rootnex_post_event(dev_info_t *dip, dev_info_t *rdip, ddi_eventcookie_t eventid, void *impl_data); /* * Clustering: Return the global devices path base, or * the entire global devices path prefix. */ const char * i_ddi_get_dpath_base(); const char * i_ddi_get_dpath_prefix(); /* * Search and return properties from the PROM */ int impl_ddi_bus_prop_op(dev_t dev, dev_info_t *dip, dev_info_t *ch_dip, ddi_prop_op_t prop_op, int mod_flags, char *name, caddr_t valuep, int *lengthp); /* * Copy an integer from PROM to native machine representation */ int impl_ddi_prop_int_from_prom(uchar_t *intp, int n); extern int impl_ddi_sunbus_initchild(dev_info_t *); extern void impl_ddi_sunbus_removechild(dev_info_t *); /* * Implementation specific access handle allocator and init. routines */ extern ddi_acc_handle_t impl_acc_hdl_alloc(int (*waitfp)(caddr_t), caddr_t arg); extern void impl_acc_hdl_free(ddi_acc_handle_t handle); extern ddi_acc_hdl_t *impl_acc_hdl_get(ddi_acc_handle_t handle); extern void impl_acc_hdl_init(ddi_acc_hdl_t *hp); /* access error handling support */ extern void impl_acc_err_init(ddi_acc_hdl_t *); extern int impl_dma_check(dev_info_t *, const void *, const void *, const void *); extern int i_ddi_ontrap(ddi_acc_handle_t); extern void i_ddi_notrap(ddi_acc_handle_t); extern int i_ddi_prot_trampoline(); extern int i_ddi_caut_trampoline(); /* * misc/bootdev entry points - these are private routines and subject * to change. */ extern int i_devname_to_promname(char *dev_name, char *ret_buf, size_t); extern int i_promname_to_devname(char *prom_name, char *ret_buf); extern char * i_convert_boot_device_name(char *, char *, size_t *); /* * Nodeid management ... */ void impl_ddi_init_nodeid(void); int impl_ddi_alloc_nodeid(int *nodeid); int impl_ddi_take_nodeid(int nodeid, int kmflag); void impl_ddi_free_nodeid(int nodeid); /* * minorname/devtspectype conversions */ extern char * i_ddi_devtspectype_to_minorname(dev_info_t *dip, dev_t dev, int spec_type); extern int i_ddi_minorname_to_devtspectype(dev_info_t *dip, char *minor_name, dev_t *devp, int *spectypep); /* * Routines in ddi_v9_asm.s */ extern int do_peek(size_t, void *, void *); extern int do_poke(size_t, void *, void *); extern void peek_fault(void); extern void poke_fault(void); extern int peekpoke_mem(ddi_ctl_enum_t, peekpoke_ctlops_t *); /* * Helper functions */ char *i_ddi_strdup(char *, uint_t); void i_ddi_prop_list_delete(ddi_prop_t *); ddi_prop_t *i_ddi_prop_list_dup(ddi_prop_t *, uint_t); int i_ddi_load_drvconf(major_t); int i_ddi_unload_drvconf(major_t); ddi_node_state_t i_ddi_node_state(dev_info_t *); int i_ddi_devi_attached(dev_info_t *); void i_ddi_parse_name(char *, char **, char **, char **); void i_ddi_set_node_state(dev_info_t *, ddi_node_state_t); int i_ddi_detach_installed_driver(major_t, int); void i_ddi_set_binding_name(dev_info_t *, char *); void i_ddi_bind_devs(); void i_ddi_unbind_devs(major_t); ddi_prop_list_t *i_ddi_prop_list_create(ddi_prop_t *); struct devnames; void i_ddi_prop_list_hold(ddi_prop_list_t *, struct devnames *); void i_ddi_prop_list_rele(ddi_prop_list_t *, struct devnames *); ddi_prop_t *i_ddi_prop_search(dev_t, char *, uint_t, ddi_prop_t **); int resolve_pathname(char *, dev_info_t **, dev_t *, int *); int i_ddi_prompath_to_devfspath(char *, char *); int i_ddi_attach_node_hierarchy(dev_info_t *); dev_info_t *i_ddi_attach_pseudo_node(char *); int i_ddi_attach_hw_nodes(char *); int i_ddi_devs_attached(major_t); int i_ddi_minor_node_count(dev_info_t *, const char *); int ddi_find_pci_parent(char *pathname, dev_info_t **pci_dipp); int ddi_is_pci_dip(dev_info_t *dip); /* non-DDI functions: wrapper around mod_hold/rele_dev_by_major() */ struct dev_ops *ddi_hold_driver(major_t); void ddi_rele_driver(major_t); /* * /etc/devices cache files management */ void i_ddi_devices_init(void); void i_ddi_read_devices_files(void); void i_ddi_clean_devices_files(void); /* * devid cache */ void devid_cache_init(void); void devid_cache_read(void); void devid_cache_cleanup(void); int i_ddi_devi_get_devid(dev_t, dev_info_t *, ddi_devid_t *); int e_ddi_devid_discovery(ddi_devid_t); int e_devid_cache_register(dev_info_t *, ddi_devid_t); void e_devid_cache_unregister(dev_info_t *); int e_devid_cache_to_devt_list(ddi_devid_t, char *, int *, dev_t **); void e_devid_cache_free_devt_list(int, dev_t *); /* * I/O retire persistent store */ void retire_store_init(void); void retire_store_read(void); int e_ddi_retire_persist(char *devpath); int e_ddi_retire_unpersist(char *devpath); int e_ddi_device_retired(char *devpath); /* * Resource control functions to lock down device memory. */ extern int i_ddi_incr_locked_memory(proc_t *, rctl_qty_t); extern void i_ddi_decr_locked_memory(proc_t *, rctl_qty_t); #endif /* _KERNEL */ #ifdef __cplusplus } #endif #endif /* _SYS_DDI_IMPLFUNCS_H */