aboutsummaryrefslogtreecommitdiffstats
path: root/docs
Commit message (Collapse)AuthorAgeFilesLines
* xen-api: Add TOC and hyperlink cross reference to xen-api documentKeir Fraser2008-02-113-1/+13
| | | | Signed-off-by: Stefan Berger <stefanb@us.ibm.com>
* Document XenStore's new SET_TARGET messageKeir Fraser2008-02-111-0/+10
| | | | Signed-off-by: Ryan O'Connor <colossus@interchange.ubc.ca>
* Add 'coredump-destroy' and 'coredump-restart' actions for crashed domains.Keir Fraser2008-02-071-0/+16
| | | | | | | | Xen-API already specifies these actions for the 'on_crash' domain exit event. This patch makes them available for use in traditional domU config files and through the xm tool as well. Signed-off-by: Jim Fehlig <jfehlig@novell.com>
* Update XenAPI version number, changelog, and cover sheet.Keir Fraser2008-01-252-2/+9
| | | | Signed-off-by: Jim Fehlig <jfehlig@novell.com>
* (Re)introduce notion of crashed VM power state.Keir Fraser2008-01-253-2/+8
| | | | | | | The crashed power state is necessary to allow both core-dumping a crashed but preserved VM and renaming/restarting a crashed VM. Signed-off-by: Jim Fehlig <jfehlig@novell.com>
* ChangeLog: Document new set_target xenstore and domctl commands.Keir Fraser2008-01-231-0/+12
| | | | Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
* Clarify 'xm mem-set' and 'xm vcpu-set' requirements in documentation.Keir Fraser2008-01-181-3/+10
| | | | | From: Richard W.M. Jones <rjones@redhat.com> Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
* Minor correction in xm man page for 'xm create'.Keir Fraser2008-01-171-1/+1
| | | | | From: Richard W.M. Jones <rjones@redhat.com> Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
* tools/docs: Fix example and default IP addresses.Keir Fraser2008-01-172-8/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In various places in documentation and code, IP addresses are provided as examples, defaults, or dummy configuration. In general the specific IP addresses used in Xen are not always appropriate. (For example, 1.2.3.4 is used in a few places!) The following addresses should be used: * For examples and documentation, 192.0.2.0/24. (See RFC3330.) * For defaults for private networks, a random network from RFC1918. I have randomly selected 172.30.206.0/24 for this purpose and documented this in at the only registry I know of, www.ucam.org/cam-grin. This network should henceforth be used for default configurations of local bridges, test networks, etc. in Xen tools. The following addresses should NOT be used: * 10.0.*.*, 10.1.*.*, 192.168.0.*, 192.168.1.*, etc. Using these addresses gives greatly increased likelihood of collision, as ignorant network administrators and reckless middlebox vendors often pick networks from the bottom of 10/8 and 192.168/16. * 169.254.*.*. These are reserved for zeroconf (ad-hoc networking) and should not be used for Xen private networks, bridges, etc., etc. Use of these addresses by Xen scripts causes trouble on hosts (eg laptops) which find themselves in ad-hoc networking environments. I think this is not hypothetical (!) since at least one Linux distribution have specific code to detect this case and cause Xen startup to fail iff the host already has an external zeroconf address. * 1.2.3.4. WTF !? I have also used 127.0.255.255 in one place where apparently a dummy address is needed (some Linux kernels won't accept a lack of an NFS server address). If 127.0.255.255 is mistakenly used it is unlikely to do any damage to real traffic even if it does escape into the network at large. Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
* Update API changelog for new feature flags.Keir Fraser2008-01-171-0/+12
| | | | Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
* x86: Document the new MMU_PT_UPDATE_PRESERVE_AD hypercall.Keir Fraser2008-01-151-0/+10
| | | | Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
* Add a ChangeLog fileKeir Fraser2008-01-081-0/+65
| | | | | | Add a file for tracking API/ABI changes and additions. Signed-off-by: John Levon <john.levon@sun.com>
* Fix some build system error handling.Keir Fraser2007-12-201-1/+1
| | | | Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
* doc: Fix serial console command line.Keir Fraser2007-12-191-1/+1
| | | | Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
* docs: Adds VT-d testing combinations and lists OS which VT-d works on.Keir Fraser2007-12-141-1/+17
| | | | Signed-off-by: Weidong Han <weidong.han@intel.com>
* xenstore size limitsKeir Fraser2007-12-141-1/+17
| | | | | | | | | | | | | | | * Documents the existing 4kby size limit on xenstore message payloads * Causes xs.c in libxenstore to fail locally rather than violating said limit (which is good because xenstored kills the client connection if it's exceeded). * Introduces some limits on path lengths in xenstored. I trust no-one is using path lengths >2kby. This is good because currently a domain client can create a 4kby relative path that the dom0 tools cannot access since they'd have to specify the somewhat longer absolute path. * Removes uses of the host's PATH_MAX (!) Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
* docs/misc/xenstore.txt minor fixesKeir Fraser2007-12-141-7/+13
| | | | Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
* Fix gdb debugging of hypervisor.Keir Fraser2007-12-121-27/+40
| | | | | | | | | | | | | This patch: * enables the gdbstubs to properly access hypervisor memory; * prevents an assertion failure in __spurious_page_fault's call to map_domain_page if such accesses fail, by testing in_irq(); * prints some additional helpful messages; * fixes the endianness of register transfers from the gdbstubs so that gdb is much less confused. * fixes the documentation in docs/misc/crashdb.txt Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
* docs: vtd.txt doc changeKeir Fraser2007-12-121-2/+12
| | | | | | Added a note on conventional PCI device passthrough. Signed-off-by: Allen Kay <allen.m.kay@intel.com>
* Add missing file from previous changeset.Keir Fraser2007-12-121-0/+20
|
* docs: Adjust revision number in Xen-API document and introduce revision history.Keir Fraser2007-12-122-2/+5
| | | | | | | | This patch adjusts the revision number to 1.0.1 and date in the Xen-API document and introduces a revision history with entries for 1.0.0 and 1.0.1. Signed-off-by: Stefan Berger <stefanB@us.ibm.com>
* xend, acm: Extend Xen-API with function to reset the policyKeir Fraser2007-12-121-0/+39
| | | | | | | | | | | | This patch extends the Xen-API and the legacy XML-RPC interface with a function to reset the policy on the system (through an update with the default policy). I adapted the code in 'xm resetpolicy' to use this now. This patch also extends libxen and the documentation to reflect the new function. Signed-off-by: Stefan Berger <stefanb@us.ibm.com>
* xenstore: document the xenstore protocolKeir Fraser2007-12-051-0/+287
| | | | | | | | | | | | | | | | | The attached patch adds a new text file docs/misc/xenstore.txt which describes the actual protocol implemented by xenstored. This was reverse-engineered from the actual code in tools/xenstore. I didn't bother making any automatic arrangements to ensure that the implemented and documented protocols are kept in step (for example, automatic code generation, etc.) The protocol is rather messy unfortunately and unsuitable for an xdr approach, and in any case is not likely to change very quickly. Also in this patch are a couple of comments for xenstored_core.c which help clarify the behaviour of some payload parsing helper functions. Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
* [USER GUIDE] [ACM/sHype Update] User Guide Update for sHype/XenKeir Fraser2007-12-053-1111/+3150
| | | | | | | | | | | | This patch updates the ACM/sHype user guide chapter. It updates the examples throughout the chapter and describes advanced security policy and domain management based on the new ACM xm command extensions that were submitted this morning (cf. http://lists.xensource.com/archives/html/xen-devel/2007-12/msg00043.html and http://lists.xensource.com/archives/html/xen-devel/2007-12/msg00041.html). Signed-off: Reiner Sailer <sailer@us.ibm.com>
* Implement legacy XML-RPC interface for ACM commands.Keir Fraser2007-12-051-37/+24
| | | | | | | | | | | | | | | | | | | | | | | | This patch implements a (non Xen-API) legacy XML-RPC interface for the ACM commands and funnels the calls into code introduced by the Xen-API support for ACM security management. Since some of the functionality has changed, also the xm applications have changed. In particular the following old commands have been removed along with some tools the have become obsolete now: - loadpolicy (included in: setpolicy) - makepolicy (included in: setpolicy) - cfgbootpolicy (included in: setpolicy) and the following commands been introduced: - setpolicy - getpolicy - resetpolicy All tools have been adapted to work in Xen-API and legacy XML-RPC mode. Both modes support the same functionality. Signed-off-by: Stefan Berger <stefanb@us.ibm.com>
* docs: Fix interface manual to correctly referenceKeir Fraser2007-12-041-1/+1
| | | | | update_va_mapping_otherdomain. Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
* Users manual updates:Keir Fraser2007-11-061-11/+11
| | | | | | | | | 1) PAE as 32-bit Xen default 2) IA64 and Power are supported 3) AMD Virtualization is supported 4) Add console_timestamps boot param Signed-off-by: Atsushi SAKAI <sakaia@jp.fujitsu.com>
* vt-d: add a vt-d howto setup documentKeir Fraser2007-10-251-0/+50
| | | | | | | docs/misc/vtd.txt is a vt-d how-to document that should answer questions about how to use vt-d with latest Xen. Signed-off-by: Allen Kay <allen.m.kay@intel.com>
* [IA64] Don't share privregs with hvm domainAlex Williamson2007-10-221-2/+6
| | | | | | | | | | | | | | | | Don't share privregs with hvm domain and twist IA64 xen dump core format slightly. Xen shares privregs pages with IA64 HVM domain for xm dump-core to dump the pages. However sharing the page allows hvm guest domain peek/destroy the page contents that might cause xen crash. And the xen dump core file doesn't need privregs page because cpu context should be obtained from vcpu context in case of IA64 HVM domain. Although this patch modify xen dump core format, current crash utility (at least crash 4.0-4.7) doesn't look into .xen_ia64_mmapped_regs section and I don't know any other tools to understand xen dump core file. So this format modification doesn't cause incompatibility issue. Signed-off-by: Isaku Yamahata <yamahata@valinux.co.jp>
* Replace sysctl.physinfo.sockets_per_node with more directly usefulKeir Fraser2007-10-191-1/+0
| | | | | | | | sysctl.physinfo.nr_cpus. This also avoids miscalculation of sockets_per_node by Xen where the number of CPUs in the system is clipped. From: Elizabeth Kon <eak@us.ibm.com> Signed-off-by: Keir Fraser <keir@xensource.com>
* [vTPM] Add set/get_other_config to Xen-API.Keir Fraser2007-10-111-0/+67
| | | | | | | | | Add get_- and set_other_config methods to the vTPM class. Write the parameters into the xenstore while the domain is running prefixing it with 'oc_'. Also I add the methods to the C library as well as the documentation. Signed-off-by: Stefan Berger <stefanb@us.ibm.com>
* Extend 'xm dumppolicy' to support Xen-APIKeir Fraser2007-10-031-1/+73
| | | | | | | | | | | | | I am extending 'xm dumppolicy' to be used via the Xen-API. For this there are two new functions in the ACM policy class: - get the currently enforced policy including statistical data from the hypervisor - get the ACM 'ssidref' of a Domain. Since this may be a ACM-specific variable or type (int) I put it into the ACM class. I extended the Xen-API documentation with the two new functions. Signed-off-by: Stefan Berger <Stefanb@us.ibm.com>
* docs: Fix typos.kfraser@localhost.localdomain2007-09-122-12/+12
| | | | Signed-off-by: Atsushi SAKAI <sakaia@jp.fujitsu.com>
* Update dump-core-foramt.txt documentation.kfraser@localhost.localdomain2007-08-301-1/+9
| | | | Signed-off-by: Isaku Yamahata <yamahata@valinux.co.jp>
* [MAN] Explanation of recent extensions to xm security subcommandskfraser@localhost.localdomain2007-07-191-44/+95
| | | | Signed-off-by: Stefan Berger <stefanb@usa.ibm.com>
* Update xen-api docs.kfraser@localhost.localdomain2007-07-191-0/+74
| | | | Signed-off-by: Stefan Berger <stefanb@us.ibm.com>
* [Docs] Documentation of extension of the Xen-API for managing security policieskfraser@localhost.localdomain2007-07-122-1/+827
| | | | | | | | Provides an extension to the Xen-API documentation with the classes and methods implemented for supporting of managing security policies using the Xen-API. Signed-off-by: Stefan Berger <stefanb@us.ibm.com>
* Xen API specification improvements.kfraser@localhost.localdomain2007-07-101-223/+254
| | | | | | | | | | | | | Move the error list to be more prominent, and explicitly document which generic error codes can be returned by all methods. Mark host CPU flags/features return value as unspecified. Document PERMISSION_DENIED. Document error returns of session.login_with_password. Signed-off-by: John Levon <john.levon@sun.com>
* docs: update xm man pagekfraser@localhost.localdomain2007-07-061-127/+162
| | | | | | | | | | - Fixed description of "Mem" column in "xm list" output. - Added a bit of text for the credit scheduler. - Described the --force option to block-detach. - Made formatting and spelling more consistent. - etc... Signed-off-by: Charles Coffing <ccoffing@novell.com>
* x86: Re-introduce VIDEO_CURRENT_MODE into video.S video-mode-settingkfraser@localhost.localdomain2007-06-191-0/+1
| | | | | code, and make visible at the command line via 'vga=current'. Signed-off-by: Keir Fraser <keir@xensource.com>
* docs: Fix docs install when graphvix is not installed.Keir Fraser2007-06-181-3/+2
| | | | Signed-off-by: Keir Fraser <keir@xensource.com>
* Update docs for 'edd=' boot option.kfraser@localhost.localdomain2007-06-141-0/+2
| | | | Signed-off-by: Keir Fraser <keir@xensource.com>
* x86: Fix VBE EDID interrogation. Add a new boot option 'edid={no,force}'.kfraser@localhost.localdomain2007-06-121-0/+7
| | | | Signed-off-by: Keir Fraser <keir@xensource.com>
* docs: Update for new 'vga=' boot option syntax.Keir Fraser2007-06-101-3/+11
| | | | Signed-off-by: Keir Fraser <keir@xensource.com>
* Bump all API version numbers to 1.0.0.ewan@localhost.localdomain2007-04-271-3/+3
| | | | Signed-off-by: Ewan Mellor <ewan@xensource.com>
* Remove non-ASCII chars in man page.kfraser@localhost.localdomain2007-04-261-9/+9
| | | | Signed-off-by: Charles Coffing <ccoffing@novell.com>
* acm: Changes to XML schema of the policykfraser@localhost.localdomain2007-04-251-26/+27
| | | | | | | | | | | This patch changes the XML schema of the ACM policy to require a version and that every conflict set have a name. Every VM label must have one Chinese Wall Type and every resource label one Simple Type Enforcement Type. As a consequence of this some example policies needed to be changed. Also not offering that many configuration options for compiling xen anymore to make things simpler. Signed-off-by: Stefan Berger <stefanb@us.ibm.com>
* API version to 0.9.1.ewan@localhost.localdomain2007-04-211-2/+2
| | | | Signed-off-by: Ewan Mellor <ewan@xensource.com>
* Added documentation and C bindings for VM.migrate call.ewan@localhost.localdomain2007-04-161-0/+41
| | | | Signed-off-by: Ewan Mellor <ewan@xensource.com>
* Added host.enabled flag.ewan@localhost.localdomain2007-04-161-0/+33
| | | | Signed-off-by: Ewan Mellor <ewan@xensource.com>