Commit Graph
490 Commits
Author SHA1 Message Date
Keir Fraser c35e8672fb xen-api: Add TOC and hyperlink cross reference to xen-api document
Signed-off-by: Stefan Berger <stefanb@us.ibm.com>
2008-02-11 14:50:50 +00:00
Keir Fraser 9990562d74 Document XenStore's new SET_TARGET message
Signed-off-by: Ryan O'Connor <colossus@interchange.ubc.ca>
2008-02-11 10:20:31 +00:00
Keir Fraser e63b739dff Add 'coredump-destroy' and 'coredump-restart' actions for crashed domains.
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>
2008-02-07 09:28:55 +00:00
Keir Fraser 13ac8fbdc8 Update XenAPI version number, changelog, and cover sheet.
Signed-off-by: Jim Fehlig <jfehlig@novell.com>
2008-01-25 16:30:34 +00:00
Keir Fraser 961f9b1fc9 (Re)introduce notion of crashed VM power state.
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>
2008-01-25 13:28:25 +00:00
Keir Fraser 291dffe4df ChangeLog: Document new set_target xenstore and domctl commands.
Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
2008-01-23 13:27:21 +00:00
Keir Fraser 2c7a4f62dc Clarify 'xm mem-set' and 'xm vcpu-set' requirements in documentation.
From: Richard W.M. Jones <rjones@redhat.com>
Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
2008-01-18 13:43:26 +00:00
Keir Fraser 653ceb13b7 Minor correction in xm man page for 'xm create'.
From: Richard W.M. Jones <rjones@redhat.com>
Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
2008-01-17 15:21:35 +00:00
Keir Fraser aac518b954 tools/docs: Fix example and default IP addresses.
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>
2008-01-17 15:13:40 +00:00
Keir Fraser 5c0d9e888d Update API changelog for new feature flags.
Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
2008-01-17 13:03:22 +00:00
Keir Fraser e606b5e41c x86: Document the new MMU_PT_UPDATE_PRESERVE_AD hypercall.
Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
2008-01-15 21:23:37 +00:00
Keir Fraser 926b04bb75 Add a ChangeLog file
Add a file for tracking API/ABI changes and additions.

Signed-off-by: John Levon <john.levon@sun.com>
2008-01-08 14:35:18 +00:00
Keir Fraser 53f48ca221 Fix some build system error handling.
Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
2007-12-20 13:16:21 +00:00
Keir Fraser 1358358f3d doc: Fix serial console command line.
Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
2007-12-19 15:53:56 +00:00
Keir Fraser 53bd75393f docs: Adds VT-d testing combinations and lists OS which VT-d works on.
Signed-off-by: Weidong Han <weidong.han@intel.com>
2007-12-14 10:22:08 +00:00
Keir Fraser 625a82b59c xenstore size limits
* 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>
2007-12-14 10:15:00 +00:00
Keir Fraser 298950dbe8 docs/misc/xenstore.txt minor fixes
Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
2007-12-14 10:12:15 +00:00
Keir Fraser bfeddb6751 Fix gdb debugging of hypervisor.
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>
2007-12-12 11:27:15 +00:00
Keir Fraser 8d8da82349 docs: vtd.txt doc change
Added a note on conventional PCI device passthrough.

Signed-off-by: Allen Kay <allen.m.kay@intel.com>
2007-12-12 10:19:44 +00:00
Keir Fraser b7eaaa90a1 Add missing file from previous changeset. 2007-12-12 10:03:09 +00:00
Keir Fraser 5ccf17bd71 docs: Adjust revision number in Xen-API document and introduce revision history.
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>
2007-12-12 09:59:53 +00:00
Keir Fraser 7d6b2ecfac xend, acm: Extend Xen-API with function to reset the policy
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>
2007-12-12 09:57:55 +00:00
Keir Fraser c5f554d5c1 xenstore: document the xenstore protocol
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>
2007-12-05 11:08:07 +00:00
Keir Fraser 2866a90337 [USER GUIDE] [ACM/sHype Update] User Guide Update for sHype/Xen
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>
2007-12-05 10:00:42 +00:00
Keir Fraser 0ea4d2fb34 Implement legacy XML-RPC interface for ACM commands.
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>
2007-12-05 09:44:20 +00:00
Keir Fraser f2399a9231 docs: Fix interface manual to correctly reference
update_va_mapping_otherdomain.
Signed-off-by: Keir Fraser <keir.fraser@citrix.com>
2007-12-04 11:16:41 +00:00
Keir Fraser d0206a01a8 Users manual updates:
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>
2007-11-06 09:41:57 +00:00
Keir Fraser 437891b12b vt-d: add a vt-d howto setup document
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>
2007-10-25 09:27:00 +01:00
Alex Williamson 34070c37f5 [IA64] Don't share privregs with hvm domain
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>
2007-10-22 12:26:53 -06:00
Keir Fraser 07f557cb63 Replace sysctl.physinfo.sockets_per_node with more directly useful
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>
2007-10-19 18:00:10 +01:00
Keir Fraser 1a55b4207e [vTPM] Add set/get_other_config to Xen-API.
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>
2007-10-11 09:41:16 +01:00
Keir Fraser 8950f5c6ba Extend 'xm dumppolicy' to support Xen-API
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>
2007-10-03 14:04:51 +01:00
kfraser@localhost.localdomain 6c6ce908aa docs: Fix typos.
Signed-off-by: Atsushi SAKAI <sakaia@jp.fujitsu.com>
2007-09-12 09:43:33 +01:00
kfraser@localhost.localdomain 9ac422f0e2 Update dump-core-foramt.txt documentation.
Signed-off-by: Isaku Yamahata <yamahata@valinux.co.jp>
2007-08-30 15:00:49 +01:00
kfraser@localhost.localdomain 3eb4247336 [MAN] Explanation of recent extensions to xm security subcommands
Signed-off-by: Stefan Berger <stefanb@usa.ibm.com>
2007-07-19 17:18:20 +01:00
kfraser@localhost.localdomain 0ba976c0c8 Update xen-api docs.
Signed-off-by: Stefan Berger <stefanb@us.ibm.com>
2007-07-19 17:00:31 +01:00
kfraser@localhost.localdomain 8c3b910735 [Docs] Documentation of extension of the Xen-API for managing security policies
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>
2007-07-12 10:06:44 +01:00
kfraser@localhost.localdomain 07f3760888 Xen API specification improvements.
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>
2007-07-10 10:22:41 +01:00
kfraser@localhost.localdomain 49562f1285 docs: update xm man page
- 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>
2007-07-06 14:45:02 +01:00
kfraser@localhost.localdomain 2f081add3e x86: Re-introduce VIDEO_CURRENT_MODE into video.S video-mode-setting
code, and make visible at the command line via 'vga=current'.
Signed-off-by: Keir Fraser <keir@xensource.com>
2007-06-19 15:09:59 +01:00
Keir Fraser 1d48812d23 docs: Fix docs install when graphvix is not installed.
Signed-off-by: Keir Fraser <keir@xensource.com>
2007-06-18 12:11:36 +01:00
kfraser@localhost.localdomain c2c3a1c11e Update docs for 'edd=' boot option.
Signed-off-by: Keir Fraser <keir@xensource.com>
2007-06-14 18:01:07 +01:00
kfraser@localhost.localdomain b2023adb2e x86: Fix VBE EDID interrogation. Add a new boot option 'edid={no,force}'.
Signed-off-by: Keir Fraser <keir@xensource.com>
2007-06-12 11:04:27 +01:00
Keir Fraser 21b1fa66ed docs: Update for new 'vga=' boot option syntax.
Signed-off-by: Keir Fraser <keir@xensource.com>
2007-06-10 19:29:32 +01:00
ewan@localhost.localdomain 05c35c5e14 Bump all API version numbers to 1.0.0.
Signed-off-by: Ewan Mellor <ewan@xensource.com>
2007-04-27 18:53:23 -07:00
kfraser@localhost.localdomain e101034b6c Remove non-ASCII chars in man page.
Signed-off-by: Charles Coffing <ccoffing@novell.com>
2007-04-26 09:52:34 +01:00
kfraser@localhost.localdomain 8c706ec28d acm: Changes to XML schema of the policy
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>
2007-04-25 09:31:52 +01:00
ewan@localhost.localdomain e969c5b9ee API version to 0.9.1.
Signed-off-by: Ewan Mellor <ewan@xensource.com>
2007-04-21 14:12:09 -07:00
ewan@localhost.localdomain 8426955edc Added documentation and C bindings for VM.migrate call.
Signed-off-by: Ewan Mellor <ewan@xensource.com>
2007-04-16 16:12:33 -04:00
ewan@localhost.localdomain f01fa26a0f Added host.enabled flag.
Signed-off-by: Ewan Mellor <ewan@xensource.com>
2007-04-16 16:10:39 -04:00