Difference between revisions of "Xen 4.3 Man Pages"

From Xen
m (Xen Man Pages)
(Checked and updated (URLs waiting for branch))
Line 3: Line 3:
 
{{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.}}
 
{{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.}}
   
== Wiki Man Pages ==
+
= Xen Man Pages =
See [[:Category:ManPage]]
 
   
  +
{| class="zebra sortable fullwidth"
== All Generated Man Pages ==
 
See [http://xenbits.xen.org/docs/4.3-testing]
 
 
<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>
 
 
== Xen Man Pages ==
 
 
{| class="zebra sortable"
 
 
|-
 
|-
!style="min-width: 200px;"| Man page
+
!style="min-width: 200px; max-width: 300px;"| Man page
 
! Description
 
! Description
!style="min-width: 100px;"| Console
+
!style="min-width: 100px; max-width: 100px;"| 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 48:
 
|}
 
|}
   
== Supporting Documents for XL & XM ==
+
= Supporting Documents for XL & XM =
   
{| class="zebra"
+
{| class="zebra fullwidth"
 
|-
 
|-
!style="min-width: 300px;"| Document
+
!style="min-width: 300px; max-width: 400px;"| Document
 
! Description
 
! Description
 
|-
 
|-
Line 79: Line 71:
 
|}
 
|}
   
== Other documents ==
+
= Advanced topics =
  +
{| class="zebra sortable fullwidth"
 
{| class="zebra sortable"
 
 
|-
 
|-
!style="min-width: 200px;"| Document(s)
+
!style="min-width: 200px; max-width: 300px;"| Document(s)
!style="min-width: 100px;"| Category
+
!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
 
| 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
 
| 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
| Developers
 
  +
|
| 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
 
| 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
 
| 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]]
  +
|-
  +
| [http://xenbits.xen.org/docs/4.3-testing/misc/xen-command-line.html Xen Hypervisor Command Line Options]
  +
| ???
  +
| List of hypervisor command line options
  +
|
  +
|-
  +
| [http://xenbits.xen.org/docs/4.3-testing/misc/efi.html EFI]
  +
| ???
  +
| Configuring Xen to work with EFI.
  +
|
  +
|-
  +
| '''More documentation''':
  +
|
  +
| 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/kexec_and_kdump.txt 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.
  +
| {{Category|Developers}}
 
|-
 
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/dump-core-format.txt Xen Core Dump Format]
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/dump-core-format.txt Xen Core Dump Format]
 
| Developers
 
| Developers
 
| Format of the output of the x{m,l} core-dump command
 
| Format of the output of the x{m,l} core-dump command
  +
| {{Category|Developers}}
|-
 
| [http://xenbits.xen.org/docs/4.3-testing/misc/xen-command-line.html Xen Hypervisor Command Line Options]
 
|
 
| List of hypervisor command line options
 
 
|-
 
|-
 
| [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
 
| 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
 
| 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="zebra sortable"
 
|-
 
!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]]

Revision as of 12:49, 24 June 2013

Icon Info.png 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


Icon todo.png To Do:

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 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
Xen Hypervisor Command Line Options ??? List of hypervisor command line options
EFI ??? Configuring Xen to work with EFI.
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!