Files
xen/tools/examples
kfraser@localhost.localdomain 3b71aa2851 [PCI] Two policy files written in what is intended to be human-readable SXP.
1. xend-pci-quirks.sxp:

Specifies which PCI device(s) may write to a set of PCI configuration
space registers.  A quirky PCI device is identified by its vendor ID,
device ID, subvendor ID, and subdevice ID.  If a matching entry is
found, the corresponding fields will be sent to the PCI bus manager.
Fields are composed of a register, size, and mask -- although the mask
field is currently unused.

The included policy file is for a range of tg3 devices, which is the
only type of quirky device I know about.  Users with other quirky
devices are invited to either add entries to this policy file or add
an entry in the permissive file, described next.  In either case, send an
email to the xen-devel list to make the device known.

2. xend-pci-permissive.sxp

Lists PCI devices that pciback should not prevent from writing to
their configuration space.  This can be necessary if, for example, a new
Tigon3 devices is released with different PCI vendor/device values
such that no entry in xend-pci-quirks.sxp is triggered.

Signed-off-by: Chris Bookholt <hap10@tycho.ncsc.mil>
2006-07-28 12:59:48 +01:00
..
2005-12-13 10:57:18 +00:00
2006-07-14 18:53:27 +01:00

Xen Control Tools - Examples
===================================

This directory contains example scripts and configurations for Xen.
For many operations you will either be able to use these scripts directly, or
incorporate code from them into your own scripts.

If you write a useful script and would like to share it, please do
send it (preferably with a little summary to go in this file) to
<xen-devel@lists.sourceforge.net> so we can add it to this directory.

block               - called by xen-backend.agent to bind/unbind dev  
block-common.sh     - sourced by block, block-*
block-enbd          - binds/unbinds network block devices
block-nbd           - binds/unbinds network block devices
external-device-migrate - called by xend for migrating external devices
locking.sh          - locking functions to prevent concurrent access to
                      critical sections inside script files
logging.sh          - logging function to log output using syslog
network-bridge      - xen network start/stop script when using bridging
network-nat         - xen network start/stop script when using NAT
network-route       - xen network start/stop script when using routing
vif-bridge          - virtual network start/stop script in bridged mode
vif-common.sh       - sourced by vif-bridge 
vif-nat             - xen virtual network start/stop script in NAT mode 
vif-route           - xen virtual network start/stop script in routed mode
vtpm                - called by xen-backend.agent to bind/unbind vTPM devices
vtpm-common.sh      - common code for vTPM handling
vtpm-delete         - remove an entry from the vTPM table given the
                      domain's name
vtpm-hotplug-common.sh - sourced by vtpm
vtpm-migration.sh   - sourced by external-device-migrate
xen-backend.agent   - calls block, vif-*, vtpm scripts to add, remove, hotplug
                      devices  
xen-backend.rules   - hotplug script rules
xend-config.sxp     - default xend configuration file
xen-hotplug-common.sh - sourced by vif-common.sh
xen-network-common.sh - sourced by vif-common.sh
xen-script-common.sh  - sourced by network-bridge, xen-hotplug-common.sh
xmexample1          - example configuration script for 'xm create'
xmexample2          - a more complex configuration script for 'xm create'
xmexample3          - an advanced configuration script for 'xm create' 
                      that utilizes the vmid
xmexample.nbd       - configuration script that uses NBD filesystems
xmexample.hvm       - a configuration script for creating a hvm domain with
                      'xm create'
xmexample.vti       - a configuration script for creating a domain on vti