Difference between revisions of "Xen 4.3 Man Pages"

From Xen
(Advanced topics: Formatting)
(Xen Configuration)
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
  +
{{ManualLayout|
{{Info|This section contains link to Xen manual pages that are generated from the Xen codebase. They reflect the state of '''4.3-testing'''. We do not yet have versions for specific Xen releases, but will have them in future}}
 
  +
__TOC__
 
  +
}}
{{TODO|'''4.3-testing''' has not been created yet at the time this document was written, thus most URL's will probably break. Also, new documents will not yet have been added. Also, add missing documents.}}
 
  +
= Xen Configuration =
 
  +
{| class="zebra sortable fullwidth"
== Wiki Man Pages ==
 
  +
|-
See [[:Category:ManPage]]
 
  +
!style="min-width: 200px; max-width: 300px;"| Page
 
  +
! Description
== All Generated Man Pages ==
 
  +
|-
See [http://xenbits.xen.org/docs/4.3-testing]
 
  +
| [http://xenbits.xen.org/docs/4.3-testing/misc/xen-command-line.html Xen CLI]
 
  +
| Command line options for Xen to be used in /boot/grub/grub.conf
<b>Note that the pages below may miss some new documents. If you do not find what you are looking for: please check the link above!</b>
 
  +
|-
 
  +
| [http://xenbits.xen.org/docs/4.3-testing/misc/efi.html EFI]
== Xen Man Pages ==
 
  +
| Configuring Xen to work with EFI.
  +
|}
   
  +
= Xen Man Pages =
{| class="wikitable sortable"
 
  +
{| class="zebra sortable fullwidth"
 
|-
 
|-
  +
!style="min-width: 200px; max-width: 300px;"| Man page
! Man page
 
 
! Description
 
! Description
  +
!style="min-width: 100px; max-width: 100px;"| Console
! Console
 
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/man/xl.1.html xl(1)]
 
| [http://xenbits.xen.org/docs/4.3-testing/man/xl.1.html xl(1)]
Line 56: Line 59:
 
|}
 
|}
   
== Supporting Documents for XL & XM ==
+
= Supporting Documents for XL & XM =
   
{| class="wikitable"
+
{| class="zebra fullwidth"
 
|-
 
|-
  +
!style="min-width: 300px; max-width: 400px;"| Document
! Document
 
 
! Description
 
! Description
 
|-
 
|-
Line 79: Line 82:
 
|}
 
|}
   
== Other documents ==
+
= Advanced Topics =
  +
{| class="zebra sortable fullwidth"
 
{| class="wikitable"
 
 
|-
 
|-
  +
!style="min-width: 200px; max-width: 300px;"| Document(s)
! Document
 
  +
!style="min-width: 100px; max-width: 100px;"| Category
! Description
 
  +
!style="min-width: 200px;"| Description
  +
!style="min-width: 100px; max-width: 200px;"| Also See
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/distro_mapping.txt Environment Variables for different Linux distros]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/distro_mapping.txt Environment Variables for different Linux distros]
  +
| Distros
 
| With directory layout differences between Red Hat, Debian, Suse and other distros one needs to set the variables for CONFIG_LEAF_DIR, SUBSYS_DIR and INITD_DIR.
 
| With directory layout differences between Red Hat, Debian, Suse and other distros one needs to set the variables for CONFIG_LEAF_DIR, SUBSYS_DIR and INITD_DIR.
  +
| [[Distros]]
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/distro_mapping.txt Distro directory layouts]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/distro_mapping.txt Distro directory layouts]
  +
| Distros
 
| Overview of the differences in directory layout between RHEL, Debian and Suse.
 
| Overview of the differences in directory layout between RHEL, Debian and Suse.
  +
| [[Distros]]
 
|-
 
|-
| [http://xenbits.xen.org/docs/4.3-testing/misc/kexec_and_kdump.txt Kexec, and kdump for Xen]
+
| [http://xenbits.xen.org/docs/4.3-testing/misc/vtd.txt How to do PCI Passthrough with VT-d]
  +
| PCI Passthrough
| Guide to using kexec to switch to a new kernel; and kdump for catching a dump image, with Xen.
 
  +
|
  +
| {{Category|VGA}}<hr> [[Xen_PCI_Passthrough|Xen PCI Passthrough Overview]], [[VTdHowTo|VT-d HowTo]]
  +
|-
  +
| [http://xenbits.xen.org/docs/4.3-testing/misc/vtpm.txt Virtual TPM support]
  +
| Security
  +
| This document gives a short introduction to the virtual TPM support in XEN and goes as far as connecting a user domain to a virtual TPM instance and doing a short test to verify success. It is assumed that the user is fairly familiar with compiling and installing XEN and Linux on a machine.
  +
| {{Category|Security}}<hr>[http://domino.research.ibm.com/comm/research_projects.nsf/pages/ssd_vtpm.index.html Virtual Trusted Platform Module (research note)]
  +
|-
  +
| [http://xenbits.xen.org/docs/4.3-testing/misc/qemu-upstream_howto_use_it.html Qemu Upstream: How to use it]
  +
| QEMU
  +
| Pointer to a wiki page documenting how to build XXen with the QEMU unstable tree.
  +
|
  +
|-
  +
| [http://xenbits.xen.org/docs/4.3-testing/misc/sedf_scheduler_mini-HOWTO.txt sEDF scheduler how to]
  +
| Scheduler / Performance
  +
| Using the SsEDF scheduler for weighted CPU sharing.
  +
| {{Category|Performance}}
  +
|-
  +
| [http://xenbits.xen.org/docs/4.3-testing/misc/xl-numa-placement.html XL placement]
  +
| Performance
  +
| NUMA Node placement.
  +
| {{Category|Performance}} {{Category|NUMA}}
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/vtd.txt VT-d HOWTO]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/vtd.txt VT-d HOWTO]
  +
| PCI Passthrough
 
| How to use Intel's VT-d extensions.
 
| How to use Intel's VT-d extensions.
  +
| {{Category|VGA}}
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/xsm-flask.txt XSM/FLASK Configuration]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/xsm-flask.txt XSM/FLASK Configuration]
  +
| Security
 
| Configuring Xen to use the XSM/FLASK mandatory access control framework
 
| Configuring Xen to use the XSM/FLASK mandatory access control framework
  +
| {{Category|Security}}<hr>[[Xen Security Modules : XSM-FLASK|XSM-FLASK]]
 
|-
 
|-
  +
| '''More documentation''':
| [http://xenbits.xen.org/docs/4.3-testing/misc/dump-core-format.txt Xen Core Dump Format]
 
  +
|
| Format of the output of the x{m,l} core-dump command
 
  +
| See [http://xenbits.xen.org/docs/4.3-testing/ Generated documents]
  +
|
  +
|}
  +
  +
= Developer Topics =
  +
  +
{| class="zebra sortable fullwidth"
 
|-
 
|-
  +
!style="min-width: 200px; max-width: 300px;"| Document(s)
  +
!style="min-width: 100px; max-width: 100px;"| Category
  +
! Description
  +
!style="min-width: 100px; max-width: 200px;"| Also See
 
|-
 
|-
| [http://xenbits.xen.org/docs/4.3-testing/misc/xen-command-line.html Xeb Hypervisor Command Line Options]
+
| [http://xenbits.xen.org/docs/4.3-testing/misc/kexec_and_kdump.txt Kexec, and kdump for Xen]
  +
| Developers
| List of hypervisor command line options
 
  +
| Guide to using kexec to switch to a new kernel; and kdump for catching a dump image, with Xen.
  +
| {{Category|Developers}}
  +
|-
  +
| [http://xenbits.xen.org/docs/4.3-testing/misc/dump-core-format.txt Xen Core Dump Format]
  +
| Developers
  +
| Format of the output of the x{m,l} core-dump command
  +
| {{Category|Developers}}
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/vbd-interface.txt Xen Guest Disk (VBD) interface]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/vbd-interface.txt Xen Guest Disk (VBD) interface]
  +
| Developers
 
| The interface exposed to DomUs for communicating with block devices.
 
| The interface exposed to DomUs for communicating with block devices.
  +
| {{Category|Developers}}
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/xenstore.txt Xenstore Protocol Definition]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/xenstore.txt Xenstore Protocol Definition]
  +
| Developers
 
| Definition of standard behaviour, when using Xenstore.
 
| Definition of standard behaviour, when using Xenstore.
  +
| {{Category|Developers}}
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/efi.html EFI]
 
| Configuring Xen to work with EFI.
 
|}
 
 
== Advanced topics ==
 
 
{| class="wikitable"
 
|-
 
!style="min-width: 200px;"| Document(s)
 
!style="min-width: 100px;"| Category
 
!style="min-width: 200px;"| Description
 
!style="min-width: 100px;"| Also See
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/vtd.txt How to do PCI Passthrough with VT-d]
 
| PCI Passthrough
 
|
 
| [[Xen_PCI_Passthrough|Xen PCI Passthrough Overview]], [[VTdHowTo|VT-d HowTo]]
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/vtpm.txt Virtual TPM support]
 
| Security
 
| This document gives a short introduction to the virtual TPM support in XEN and goes as far as connecting a user domain to a virtual TPM instance and doing a short test to verify success. It is assumed that the user is fairly familiar with compiling and installing XEN and Linux on a machine.
 
| [http://domino.research.ibm.com/comm/research_projects.nsf/pages/ssd_vtpm.index.html Virtual Trusted Platform Module (research note)]
 
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/grant-tables.txt A rough introduction to using grant tables]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/grant-tables.txt A rough introduction to using grant tables]
 
| Developers
 
| Developers
 
| Explanation of the data structures, and hypercalls required to share memory between domains.
 
| Explanation of the data structures, and hypercalls required to share memory between domains.
  +
| {{Category|Developers}}
|
 
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/xen-error-handling.txt Xen Error Handling]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/xen-error-handling.txt Xen Error Handling]
 
| Developers
 
| Developers
 
| Explanation of the various types of error (BUG, ASSERT etc) that the hypervisor, and guest can call.
 
| Explanation of the various types of error (BUG, ASSERT etc) that the hypervisor, and guest can call.
  +
| {{Category|Developers}}
|
 
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/hvm-emulated-unplug.html Xen HVM emulated device unplug protocol]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/hvm-emulated-unplug.html Xen HVM emulated device unplug protocol]
 
| Developers
 
| Developers
 
| Definition of the protocol used to disconnect emulated deivces, get log messages from drivers, and prevent Dom0 from loading specific drivers.
 
| Definition of the protocol used to disconnect emulated deivces, get log messages from drivers, and prevent Dom0 from loading specific drivers.
  +
| {{Category|Developers}}
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/xenpaging.txt Xen paging]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/xenpaging.txt Xen paging]
 
| Developers
 
| Developers
 
| Allow the sum of memory allocated to guests > physical memory available, by paging out.
 
| Allow the sum of memory allocated to guests > physical memory available, by paging out.
  +
| {{Category|Developers}}
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/crashdb.txt Xen Crash Debugger]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/crashdb.txt Xen Crash Debugger]
 
| Developers
 
| Developers
 
| Using gdb to analyse why Xen has crashed.
 
| Using gdb to analyse why Xen has crashed.
  +
| {{Category|Developers}}
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/qemu-upstream_howto_use_it.html Qemu Upstream: How to use it]
 
| QEMU
 
| Pointer to a wiki page documenting how to build XXen with the QEMU unstable tree.
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/sedf_scheduler_mini-HOWTO.txt sEDF scheduler how to]
 
| Scheduler / Performance
 
| Using the SsEDF scheduler for weighted CPU sharing.
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/xl-numa-placement.html XL placement]
 
| Performance
 
| NUMA Node placement.
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/xsm-flask.txt XSM-Flask]
 
| Security
 
|-
 
| '''More documentation''':
 
|
 
| See [http://xenbits.xen.org/docs/4.3-testing/ Generated documents]
 
 
|}
 
|}
  +
  +
  +
= Also See =
  +
* [[:Category:ManPage]]
  +
* [http://xenbits.xen.org/docs/4.3-testing] : All generated pages
  +
  +
<b>Note that the pages below may miss some new documents. If you do not find what you are looking for: please check the link above!</b>
   
 
[[Category:Xen]]
 
[[Category:Xen]]

Latest revision as of 08:29, 18 October 2013

Book Help Manual Search.png

 

Xen Configuration

Page Description
Xen CLI Command line options for Xen to be used in /boot/grub/grub.conf
EFI Configuring Xen to work with EFI.

Xen Man Pages

Man page Description Console
xl(1) Xen management tool, based on LibXenlight XL
xm(1) Xen management user interface (deprecated, also see Xen 4.1 Upgrade Notes) XM
xend-config.sxp(5) Xen daemon configuration file (deprecated, also see Xen 4.1 Upgrade Notes) XM
xl.cfg(5) XL Domain Configuration File Syntax: to create a VM (a domain in Xen terminology, sometimes called a guest) with xl requires the provision of a domain config file. XL
xl.conf(5) XL Global/Host Configuration: allows configuration of hostwide xl toolstack options XL
xlcpupool.cfg(5) XL Cpupool Configuration File Syntax: to create a Cpupool with xl requires the provision of a cpupool config file. XL
xmdomain.cfg(5) XM domain config file format (deprecated, also see Xen 4.1 Upgrade Notes) XM
xentop(1) xentop displays information about the Xen system and domains, in a continually-updating manner. XENTOP
xenpm(1) Xenpm is a userspace tool that can list the power information of available processors and control the power policy according to users' preference. XENPM

Supporting Documents for XL & XM

Document Description
xl.cfg(5), disk configuration This document specifies the xl config file format disk configuration option.
xl.cfg(5), network configuration This document specifies the xl config file format vif configuration option.
xl.cfg(5), tsc_mode configuration In Xen 4 a new config option called tsc_mode may be specified for each domain. This document is targeted for Xen users and administrators that may need to select a non-default tsc_mode.
xm.cfg(5), sEDF scheduler The sEDF scheduler provides weighted CPU sharing in an intuitive way and uses realtime-algorithms to ensure time guarantees.
xl-numa.cfg(5), Guest Automatic NUMA placement in LIBXL and XL This document describes the automatic placement options for NUMA hardware in XL.

Advanced Topics

Document(s) Category Description Also See
Environment Variables for different Linux distros Distros With directory layout differences between Red Hat, Debian, Suse and other distros one needs to set the variables for CONFIG_LEAF_DIR, SUBSYS_DIR and INITD_DIR. Distros
Distro directory layouts Distros Overview of the differences in directory layout between RHEL, Debian and Suse. Distros
How to do PCI Passthrough with VT-d PCI Passthrough VGA
Xen PCI Passthrough Overview, VT-d HowTo
Virtual TPM support Security This document gives a short introduction to the virtual TPM support in XEN and goes as far as connecting a user domain to a virtual TPM instance and doing a short test to verify success. It is assumed that the user is fairly familiar with compiling and installing XEN and Linux on a machine. Security
Virtual Trusted Platform Module (research note)
Qemu Upstream: How to use it QEMU Pointer to a wiki page documenting how to build XXen with the QEMU unstable tree.
sEDF scheduler how to Scheduler / Performance Using the SsEDF scheduler for weighted CPU sharing. Performance
XL placement Performance NUMA Node placement. Performance NUMA
VT-d HOWTO PCI Passthrough How to use Intel's VT-d extensions. VGA
XSM/FLASK Configuration Security Configuring Xen to use the XSM/FLASK mandatory access control framework Security
XSM-FLASK
More documentation: See Generated documents

Developer Topics

Document(s) Category Description Also See
Kexec, and kdump for Xen Developers Guide to using kexec to switch to a new kernel; and kdump for catching a dump image, with Xen. Developers
Xen Core Dump Format Developers Format of the output of the x{m,l} core-dump command Developers
Xen Guest Disk (VBD) interface Developers The interface exposed to DomUs for communicating with block devices. Developers
Xenstore Protocol Definition Developers Definition of standard behaviour, when using Xenstore. Developers
A rough introduction to using grant tables Developers Explanation of the data structures, and hypercalls required to share memory between domains. Developers
Xen Error Handling Developers Explanation of the various types of error (BUG, ASSERT etc) that the hypervisor, and guest can call. Developers
Xen HVM emulated device unplug protocol Developers Definition of the protocol used to disconnect emulated deivces, get log messages from drivers, and prevent Dom0 from loading specific drivers. Developers
Xen paging Developers Allow the sum of memory allocated to guests > physical memory available, by paging out. Developers
Xen Crash Debugger Developers Using gdb to analyse why Xen has crashed. Developers


Also See

Note that the pages below may miss some new documents. If you do not find what you are looking for: please check the link above!