83c4dfe9546fd839e7a52bca7e9920da918f916ejg/*
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * CDDL HEADER START
83c4dfe9546fd839e7a52bca7e9920da918f916ejg *
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * The contents of this file are subject to the terms of the
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * Common Development and Distribution License (the "License").
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * You may not use this file except in compliance with the License.
83c4dfe9546fd839e7a52bca7e9920da918f916ejg *
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * or http://www.opensolaris.org/os/licensing.
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * See the License for the specific language governing permissions
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * and limitations under the License.
83c4dfe9546fd839e7a52bca7e9920da918f916ejg *
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * When distributing Covered Code, include this CDDL HEADER in each
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * If applicable, add the following below this CDDL HEADER, with the
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * fields enclosed by brackets "[]" replaced with your own identifying
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * information: Portions Copyright [yyyy] [name of copyright owner]
83c4dfe9546fd839e7a52bca7e9920da918f916ejg *
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * CDDL HEADER END
83c4dfe9546fd839e7a52bca7e9920da918f916ejg */
83c4dfe9546fd839e7a52bca7e9920da918f916ejg/*
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * Use is subject to license terms.
83c4dfe9546fd839e7a52bca7e9920da918f916ejg */
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#ifndef _SYS_DEVID_CACHE_H
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define _SYS_DEVID_CACHE_H
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#pragma ident "%Z%%M% %I% %E% SMI"
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#ifdef __cplusplus
83c4dfe9546fd839e7a52bca7e9920da918f916ejgextern "C" {
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#endif
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#include <sys/list.h>
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg/*
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * The top-level nvpair identifiers in the
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * /etc/devices/devid_cache nvlist format
83c4dfe9546fd839e7a52bca7e9920da918f916ejg */
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DP_DEVID_ID "devid"
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#ifdef _KERNEL
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg/* devid-specific list element */
83c4dfe9546fd839e7a52bca7e9920da918f916ejgtypedef struct nvp_devid {
83c4dfe9546fd839e7a52bca7e9920da918f916ejg int nvp_flags;
83c4dfe9546fd839e7a52bca7e9920da918f916ejg char *nvp_devpath;
83c4dfe9546fd839e7a52bca7e9920da918f916ejg dev_info_t *nvp_dip;
83c4dfe9546fd839e7a52bca7e9920da918f916ejg ddi_devid_t nvp_devid;
83c4dfe9546fd839e7a52bca7e9920da918f916ejg list_node_t nvp_link; /* link to next element */
83c4dfe9546fd839e7a52bca7e9920da918f916ejg} nvp_devid_t;
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg/*
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * nvp_flags - devid
83c4dfe9546fd839e7a52bca7e9920da918f916ejg */
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define NVP_DEVID_REGISTERED 0x01 /* devid registered on this boot */
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define NVP_DEVID_DIP 0x02 /* devinfo valid for this devid */
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg/*
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * tunables - see devid_cache.c for more details
83c4dfe9546fd839e7a52bca7e9920da918f916ejg */
83c4dfe9546fd839e7a52bca7e9920da918f916ejgextern int devid_discovery_boot;
83c4dfe9546fd839e7a52bca7e9920da918f916ejgextern int devid_discovery_postboot;
83c4dfe9546fd839e7a52bca7e9920da918f916ejgextern int devid_discovery_postboot_always;
83c4dfe9546fd839e7a52bca7e9920da918f916ejgextern int devid_discovery_secs;
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejgextern int devid_cache_read_disable;
83c4dfe9546fd839e7a52bca7e9920da918f916ejgextern int devid_cache_write_disable;
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg/*
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * More thorough error reporting available both debug &
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * non-debug kernels, but turned off by default.
83c4dfe9546fd839e7a52bca7e9920da918f916ejg */
83c4dfe9546fd839e7a52bca7e9920da918f916ejgextern int devid_report_error; /* devid cache operations */
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg/*
83c4dfe9546fd839e7a52bca7e9920da918f916ejg * function prototypes
83c4dfe9546fd839e7a52bca7e9920da918f916ejg */
83c4dfe9546fd839e7a52bca7e9920da918f916ejgstatic int devid_cache_pack_list(nvf_handle_t, nvlist_t **);
83c4dfe9546fd839e7a52bca7e9920da918f916ejgstatic int devid_cache_unpack_nvlist(nvf_handle_t, nvlist_t *, char *);
83c4dfe9546fd839e7a52bca7e9920da918f916ejgstatic void devid_list_free(nvf_handle_t);
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#ifdef DEBUG
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_DEBUG(args) { if (devid_debug) cmn_err args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_DEBUG1(args) { if (devid_debug > 1) cmn_err args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_DEBUG2(args) { if (devid_debug > 2) cmn_err args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_DUMP(args) { if (devid_debug > 2) args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_REG(args) { if (devid_log_registers) devid_log args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_FIND(args) { if (devid_log_finds) devid_log args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_LOOKUP(args) { if (devid_log_lookups) cmn_err args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_MATCH(args) { if (devid_log_matches) devid_log args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_PATHS(args) { if (devid_log_paths) cmn_err args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_ERR(args) { if (devid_log_failures) devid_log args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_DISC(args) { if (devid_log_discovery) cmn_err args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_HOLD(args) { if (devid_log_hold) cmn_err args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_UNREG(args) { if (devid_log_unregisters) cmn_err args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_REMOVE(args) { if (devid_log_removes) cmn_err args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_STALE(args) { if (devid_log_stale) devid_log args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_DETACH(args) { if (devid_log_detaches) cmn_err args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define NVP_DEVID_DEBUG_PATH(arg) { \
83c4dfe9546fd839e7a52bca7e9920da918f916ejg if (nvp_devid_debug) \
83c4dfe9546fd839e7a52bca7e9920da918f916ejg cmn_err(CE_CONT, "%s\n", arg); \
83c4dfe9546fd839e7a52bca7e9920da918f916ejg }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define NVP_DEVID_DEBUG_DEVID(arg) { \
83c4dfe9546fd839e7a52bca7e9920da918f916ejg if (nvp_devid_debug) { \
83c4dfe9546fd839e7a52bca7e9920da918f916ejg char *ds = ddi_devid_str_encode(arg, NULL); \
83c4dfe9546fd839e7a52bca7e9920da918f916ejg cmn_err(CE_CONT, "devid: %s\n", ds); \
83c4dfe9546fd839e7a52bca7e9920da918f916ejg ddi_devid_str_free(ds); \
83c4dfe9546fd839e7a52bca7e9920da918f916ejg } \
83c4dfe9546fd839e7a52bca7e9920da918f916ejg }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejgstatic void devid_log(char *, ddi_devid_t, char *);
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#else
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_DEBUG(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_DEBUG1(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_DEBUG2(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_DUMP(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_REG(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_FIND(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_LOOKUP(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_MATCH(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_PATHS(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_ERR(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_DISC(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_HOLD(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_UNREG(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_REMOVE(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_STALE(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVID_LOG_DETACH(args)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define NVP_DEVID_DEBUG_PATH(arg)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define NVP_DEVID_DEBUG_DEVID(arg)
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#endif /* DEBUG */
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#define DEVIDERR(args) { if (devid_report_error) cmn_err args; }
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#endif /* _KERNEL */
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#ifdef __cplusplus
83c4dfe9546fd839e7a52bca7e9920da918f916ejg}
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#endif
83c4dfe9546fd839e7a52bca7e9920da918f916ejg
83c4dfe9546fd839e7a52bca7e9920da918f916ejg#endif /* _SYS_DEVID_CACHE_H */