mirror of
https://github.com/freebsd/freebsd-src
synced 2024-09-06 17:18:32 +00:00
224 lines
6.9 KiB
C
224 lines
6.9 KiB
C
/******************************************************************************
|
|
* Copyright (C) 2005 Rusty Russell, IBM Corporation
|
|
* Copyright (C) 2005 XenSource Ltd.
|
|
*
|
|
* This file may be distributed separately from the Linux kernel, or
|
|
* incorporated into other software packages, subject to the following license:
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this source file (the "Software"), to deal in the Software without
|
|
* restriction, including without limitation the rights to use, copy, modify,
|
|
* merge, publish, distribute, sublicense, and/or sell copies of the Software,
|
|
* and to permit persons to whom the Software is furnished to do so, subject to
|
|
* the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
|
|
* IN THE SOFTWARE.
|
|
*/
|
|
|
|
/**
|
|
* \file xenbusvar.h
|
|
*
|
|
* \brief Datastructures and function declarations for usedby device
|
|
* drivers operating on the XenBus.
|
|
*/
|
|
|
|
#ifndef _XEN_XENBUS_XENBUSVAR_H
|
|
#define _XEN_XENBUS_XENBUSVAR_H
|
|
|
|
#include <sys/queue.h>
|
|
#include <sys/bus.h>
|
|
#include <sys/eventhandler.h>
|
|
#include <sys/malloc.h>
|
|
#include <sys/sbuf.h>
|
|
|
|
#include <machine/stdarg.h>
|
|
|
|
#include <xen/xen-os.h>
|
|
#include <contrib/xen/grant_table.h>
|
|
#include <contrib/xen/io/xenbus.h>
|
|
#include <contrib/xen/io/xs_wire.h>
|
|
|
|
#include <xen/xenstore/xenstorevar.h>
|
|
|
|
/* XenBus allocations including XenStore data returned to clients. */
|
|
MALLOC_DECLARE(M_XENBUS);
|
|
|
|
enum {
|
|
/**
|
|
* Path of this device node.
|
|
*/
|
|
XENBUS_IVAR_NODE,
|
|
|
|
/**
|
|
* The device type (e.g. vif, vbd).
|
|
*/
|
|
XENBUS_IVAR_TYPE,
|
|
|
|
/**
|
|
* The state of this device (not the otherend's state).
|
|
*/
|
|
XENBUS_IVAR_STATE,
|
|
|
|
/**
|
|
* Domain ID of the other end device.
|
|
*/
|
|
XENBUS_IVAR_OTHEREND_ID,
|
|
|
|
/**
|
|
* Path of the other end device.
|
|
*/
|
|
XENBUS_IVAR_OTHEREND_PATH
|
|
};
|
|
|
|
/**
|
|
* Simplified accessors for xenbus devices:
|
|
*
|
|
* xenbus_get_node
|
|
* xenbus_get_type
|
|
* xenbus_get_state
|
|
* xenbus_get_otherend_id
|
|
* xenbus_get_otherend_path
|
|
*/
|
|
#define XENBUS_ACCESSOR(var, ivar, type) \
|
|
__BUS_ACCESSOR(xenbus, var, XENBUS, ivar, type)
|
|
|
|
XENBUS_ACCESSOR(node, NODE, const char *)
|
|
XENBUS_ACCESSOR(type, TYPE, const char *)
|
|
XENBUS_ACCESSOR(state, STATE, enum xenbus_state)
|
|
XENBUS_ACCESSOR(otherend_id, OTHEREND_ID, int)
|
|
XENBUS_ACCESSOR(otherend_path, OTHEREND_PATH, const char *)
|
|
|
|
/**
|
|
* Return the state of a XenBus device.
|
|
*
|
|
* \param path The root XenStore path for the device.
|
|
*
|
|
* \return The current state of the device or XenbusStateClosed if no
|
|
* state can be read.
|
|
*/
|
|
XenbusState xenbus_read_driver_state(const char *path);
|
|
|
|
/**
|
|
* Return the state of the "other end" (peer) of a XenBus device.
|
|
*
|
|
* \param dev The XenBus device whose peer to query.
|
|
*
|
|
* \return The current state of the peer device or XenbusStateClosed if no
|
|
* state can be read.
|
|
*/
|
|
static inline XenbusState
|
|
xenbus_get_otherend_state(device_t dev)
|
|
{
|
|
return (xenbus_read_driver_state(xenbus_get_otherend_path(dev)));
|
|
}
|
|
|
|
/**
|
|
* Grant access to the given ring_mfn to the peer of the given device.
|
|
*
|
|
* \param dev The device granting access to the ring page.
|
|
* \param ring_mfn The guest machine page number of the page to grant
|
|
* peer access rights.
|
|
* \param refp[out] The grant reference for the page.
|
|
*
|
|
* \return On success, 0. Otherwise an errno value indicating the
|
|
* type of failure.
|
|
*
|
|
* A successful call to xenbus_grant_ring should be paired with a call
|
|
* to gnttab_end_foreign_access() when foregn access to this page is no
|
|
* longer requried.
|
|
*
|
|
* \note On error, \a dev will be switched to the XenbusStateClosing
|
|
* state and the returned error is saved in the per-device error node
|
|
* for \a dev in the XenStore.
|
|
*/
|
|
int xenbus_grant_ring(device_t dev, unsigned long ring_mfn, grant_ref_t *refp);
|
|
|
|
/**
|
|
* Record the given errno, along with the given, printf-style, formatted
|
|
* message in dev's device specific error node in the XenStore.
|
|
*
|
|
* \param dev The device which encountered the error.
|
|
* \param err The errno value corresponding to the error.
|
|
* \param fmt Printf format string followed by a variable number of
|
|
* printf arguments.
|
|
*/
|
|
void xenbus_dev_error(device_t dev, int err, const char *fmt, ...)
|
|
__attribute__((format(printf, 3, 4)));
|
|
|
|
/**
|
|
* va_list version of xenbus_dev_error().
|
|
*
|
|
* \param dev The device which encountered the error.
|
|
* \param err The errno value corresponding to the error.
|
|
* \param fmt Printf format string.
|
|
* \param ap Va_list of printf arguments.
|
|
*/
|
|
void xenbus_dev_verror(device_t dev, int err, const char *fmt, va_list ap)
|
|
__attribute__((format(printf, 3, 0)));
|
|
|
|
/**
|
|
* Equivalent to xenbus_dev_error(), followed by
|
|
* xenbus_set_state(dev, XenbusStateClosing).
|
|
*
|
|
* \param dev The device which encountered the error.
|
|
* \param err The errno value corresponding to the error.
|
|
* \param fmt Printf format string followed by a variable number of
|
|
* printf arguments.
|
|
*/
|
|
void xenbus_dev_fatal(device_t dev, int err, const char *fmt, ...)
|
|
__attribute__((format(printf, 3, 4)));
|
|
|
|
/**
|
|
* va_list version of xenbus_dev_fatal().
|
|
*
|
|
* \param dev The device which encountered the error.
|
|
* \param err The errno value corresponding to the error.
|
|
* \param fmt Printf format string.
|
|
* \param ap Va_list of printf arguments.
|
|
*/
|
|
void xenbus_dev_vfatal(device_t dev, int err, const char *fmt, va_list)
|
|
__attribute__((format(printf, 3, 0)));
|
|
|
|
/**
|
|
* Convert a member of the xenbus_state enum into an ASCII string.
|
|
*
|
|
* /param state The XenBus state to lookup.
|
|
*
|
|
* /return A string representing state or, for unrecognized states,
|
|
* the string "Unknown".
|
|
*/
|
|
const char *xenbus_strstate(enum xenbus_state state);
|
|
|
|
/**
|
|
* Return the value of a XenBus device's "online" node within the XenStore.
|
|
*
|
|
* \param dev The XenBus device to query.
|
|
*
|
|
* \return The value of the "online" node for the device. If the node
|
|
* does not exist, 0 (offline) is returned.
|
|
*/
|
|
int xenbus_dev_is_online(device_t dev);
|
|
|
|
/**
|
|
* Default callback invoked when a change to the local XenStore sub-tree
|
|
* for a device is modified.
|
|
*
|
|
* \param dev The XenBus device whose tree was modified.
|
|
* \param path The tree relative sub-path to the modified node. The empty
|
|
* string indicates the root of the tree was destroyed.
|
|
*/
|
|
void xenbus_localend_changed(device_t dev, const char *path);
|
|
|
|
#include "xenbus_if.h"
|
|
|
|
#endif /* _XEN_XENBUS_XENBUSVAR_H */
|