aboutsummaryrefslogtreecommitdiffstats
path: root/docs/man
Commit message (Collapse)AuthorAgeFilesLines
...
* docs: various typosTim Deegan2012-06-284-18/+18
| | | | | | Signed-off-by: Tim Deegan <tim@xen.org> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson.citrix.com>
* docs: Use lists.xen.org not lists.xensource.comIan Campbell2012-06-283-3/+3
| | | | | | | | | | [ Also s/greatful/grateful/, twice -iwj ] Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Acked-by: Keir Fraser <keir@xen.org> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* xl.cfg: document the cpuid= optionOlaf Hering2012-06-081-3/+47
| | | | | Signed-off-by: Olaf Hering <olaf@aepfle.de> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* xl.cfg: document the maxmem= optionOlaf Hering2012-06-061-4/+10
| | | | | | Signed-off-by: Olaf Hering <olaf@aepfle.de> Acked-by: Ian Campbell <ian.campbell@citrix.com> Committed-by: Ian Campbell <ian.campbell@citrix.com>
* xl/libxl: add a blkdev_start parameterStefano Stabellini2012-05-291-0/+6
| | | | | | | | | | | | | | | | Introduce a blkdev_start in xl.conf and a corresponding string in libxl_domain_build_info. Add a blkdev_start parameter to libxl__device_disk_local_attach: it is going to be used in a following patch. blkdev_start specifies the first block device to be used for temporary block device allocations by the toolstack. Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Acked-by: Ian Campbell <ian.campbell@citrix.com> Committed-by: Ian Campbell <ian.campbell@citrix.com>
* xl: Remus - fix docsShriram Rajagopalan2012-05-291-3/+5
| | | | | | | | | Explicitly mention that the current state of Remus support in xl is experimental, with no disk/network buffering support. Signed-off-by: Shriram Rajagopalan <rshriram@cs.ubc.ca> Acked-by: Ian Campbell <ian.campbell@citrix.com> Committed-by: Ian Campbell <ian.campbell@citrix.com>
* libxl: Remus - xl remus commandShriram Rajagopalan2012-05-181-0/+35
| | | | | | | | | | | | | | xl remus acts as a frontend to enable remus for a given domain. * At the moment, only memory checkpointing and blackhole replication is supported. Support for disk checkpointing and network buffering will be added in future. * Replication is done over ssh connection currently (like live migration with xl). Future versions will have an option to use simple tcp socket based replication channel (for both Remus & live migration). Signed-off-by: Shriram Rajagopalan <rshriram@cs.ubc.ca> Acked-by: Ian Campbell <ian.campbell@citrix.com> Committed-by: Ian Campbell <ian.campbell@citrix.com>
* xl: Add pci_assignable_add and remove commandsGeorge Dunlap2012-05-151-0/+22
| | | | | | | | pci-assignable-add will always store the driver rebind path, but pci-assignable-remove will only actually rebind if asked to do so. Signed-off-by: George Dunlap <george.dunlap@eu.citrix.com> Committed-by: Ian Campbell <ian.campbell@citrix.com>
* libxl: Rename pci_list_assignable to pci_assignable_listGeorge Dunlap2012-05-151-7/+7
| | | | | | | | | | | | | ...to prepare for a consistent "pci_assignable_*" naming scheme. Also move the man page entry into the PCI PASS-THROUGH section, rather than the XEN HOST section. No functional changes. Signed-off-by: George Dunlap <george.dunlap@eu.citrix.com> Acked-by: Ian Campbell <ian.campbell@citrix.com> Committed-by: Ian Campbell <ian.campbell@citrix.com>
* xl: Introduce vncviewer xm compatibility optionsGoncalo Gomes2012-05-152-0/+22
| | | | | Signed-off-by: Goncalo Gomes <Goncalo.Gomes@EU.CITRIX.COM> Committed-by: Ian Campbell <ian.campbell@citrix.com>
* xl: introduce specific VCPU to PCPU mapping in config fileDario Faggioli2012-05-151-7/+19
| | | | | | | | | | | | | | | | | | | xm supports the following syntax (in the config file) for specific VCPU to PCPU mapping: cpus = "0-3,5,^1" # all vcpus run on cpus 0,2,3,5 cpus = ["2", "3"] # VCPU0 runs on CPU2, VCPU1 runs on CPU3 Allow for the same in xl. This fixes what happened in changeset 54000bca7a6a, which introduced suppot for the `cpus=` option within xl, but used both the list (cpus=[2, 3]) and the string (cpus="2,3") syntax for achieving the same behaviour (pin all guest's vcpus to the pcpus in the list/string). Signed-off-by: Dario Faggioli <dario.faggioli@citrix.com> Committed-by: Ian Campbell <ian.campbell@citrix.com>
* libxl: prevent xl from doing operations on domains if xend is runningRoger Pau Monne2012-05-141-0/+6
| | | | | | | | | Prevent xl from doing any operation if xend daemon is running. That prevents bugs that happened when xl and xend raced to close a domain. Signed-off-by: Roger Pau Monne <roger.pau@citrix.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* xl: xl.cfg: fix typo in opengl sectionOlaf Hering2012-05-071-1/+1
| | | | | | | | Add missing i to qemu-xen-traditonal Signed-off-by: Olaf Hering <olaf@aepfle.de> Committed-by: Ian Jackson <ian.jackson.citrix.com> Acked-by: Ian Campbell <ian.campbell@citrix.com>
* libxl: set domain scheduling parameters while creating the domUDieter Bloms2012-04-251-0/+38
| | | | | | | | | | | | | | the domain specific scheduling parameters like cpu_weight, cap, slice, ... will be set during creating the domain, so this parameters can be defined in the domain config file [ Improved the documentation wording slightly. -iwj ] Signed-off-by: Dieter Bloms <dieter@bloms.de> Acked-by: Ian Campbell <Ian.Campbell@citrix.com> Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* [v2] xl: Don't require a config file for cpupoolsGeorge Dunlap2012-04-241-4/+6
| | | | | | | | | | | Since the key information can be fairly simply put on the command-line, there's no need to require an actual config file. Also improve the help to cross-reference the xlcpupool.cfg manpage. Signed-off-by: George Dunlap <george.dunlap@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson.citrix.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com>
* libxl: Remove libxl_tmem_destroy and associated xl commandIan Campbell2012-04-161-4/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Dan Magenheimer explains in <4c2f7fca-dda2-4598-aaab-3a6a3fe532cd@default>: I think the tmem_destroy functionality pre-dates the existence of tmem "freeable" memory* and was a way for a toolset to force the hypervisor to free up the hypervisor memory used by some or all ephemeral tmem pools. Once the tmem allocation/free process was directly linked into alloc_heap_pages() in the hypervisor (see call to tmem_relinquish_pages()), this forcing function was no longer needed. So, bottom line, I *think* it can be ripped out, or at least for now removed from the definition of the stable xl API/UI. The libxl.c routine libxl_tmem_destroy() could also be removed if you like, but I guess I'd prefer to leave the lower level droppings in xc.c and in the hypervisor in case I am misremembering. Accordingly remove this interface from libxl and xl but don't touch libxc or the hypervisor. This is the only libxl_tmem_* function which might potentially have required conversion to be asynchronous and which therefore might have been a potential API stability concern. Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Committed-by: Ian Jackson <ian.jackson.citrix.com> Acked-by: Dan Magenheimer <dan.magenheimer@oracle.com>
* xl, libxl: Add per-device and global permissive config options for pci ↵George Dunlap2012-04-041-0/+21
| | | | | | | | | | | | | | | | | | | | | | | passthrough By default pciback only allows PV guests to write "known safe" values into PCI config space. But many devices require writes to other areas of config space in order to operate properly. One way to do that is with the "quirks" interface, which specifies areas known safe to a particular device; the other way is to mark a device as "permissive", which tells pciback to allow all config space writes for that domain and device. This adds a "permissive" flag to the libxl_pci struct and teaches libxl how to write the appropriate value into sysfs to enable the permissive feature for devices being passed through. It also adds the permissive config options either on a per-device basis, or as a global option in the xl command-line. Because of the potential stability and security implications of enabling permissive, the flag is left off by default. Signed-off-by: George Dunlap <george.dunlap@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson.citrix.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com>
* docs: Document vcpu-pinning in guest config fileDario Faggioli2012-04-021-0/+7
| | | | | | | Chageset 54000bca7a6a didn't affect xl.cfg.pod.5 properly. Signed-off-by: Dario Faggioli <dario.faggioli@citrix.com> Committed-by: Ian Jackson <ian.jackson.citrix.com>
* libxl: support for "rtc_timeoffset" and "localtime"Lin Ming2012-04-021-0/+8
| | | | | | | | | | | | | | | | | | | Implement "rtc_timeoffset" and "localtime" options compatible as xm. rtc_timeoffset is the offset between host time and guest time. localtime means to specify whether the emulted RTC appears as UTC or is offset by the host. Acked-by: Ian Campbell <ian.campbell@citrix.com> Signed-off-by: Lin Ming <mlin@ss.pku.edu.cn> Committed-by: Ian Jackson <ian.jackson.citrix.com> --- docs/man/xl.cfg.pod.5 | 8 ++++++++ tools/libxl/libxl_create.c | 11 +++++++++++ tools/libxl/libxl_dom.c | 3 +++ tools/libxl/libxl_types.idl | 2 ++ tools/libxl/xl_cmdimpl.c | 5 +++++ 5 files changed, 29 insertions(+), 0 deletions(-)
* xl: provide a command to set the saved configuration for a running domainIan Campbell2012-04-021-0/+25
| | | | | | | Pickup this new configuration on reboot. Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Committed-by: Ian Jackson <ian.jackson.citrix.com>
* xl: Implement sched-credit schedule parameter command-line interfaceGeorge Dunlap2012-03-141-0/+47
| | | | | | | | | Add features to the sched-credit interface to allow querying and displaying scheduler parameters. Signed-off-by: George Dunlap <george.dunlap@eu.citrix.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* libxl, xl: Add the bios option to specify the bios to loadAttilio Rao2012-02-291-0/+27
| | | | | | Signed-off-by: Attilio Rao <attilio.rao@citrix.com> Acked-by: Ian Campbell <ian.campbell@citrix.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* docs/man: correct autoballoon in xl.confOlaf Hering2012-02-201-2/+2
| | | | | | | | Correct wording and default value of autoballoon= in xl.conf(5) to match code and supplied xl.conf. Signed-off-by: Olaf Hering <olaf@aepfle.de> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* Add xlcpupool.cfg man pageJuergen Gross2012-02-201-0/+117
| | | | | | | | Add a man page describing the configuration file for creating cpupools via xl cpupool-create. Signed-off-by: Juergen Gross <juergen.gross@ts.fujitsu.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* man/xl.cfg: mention not yet documented optionsOlaf Hering2012-02-201-0/+32
| | | | | | | | | | | | | | | | | | | | | | | | | | Add dummy entries for parsed but undocumented cfg file options to xl.cfg: for i in ` grep -Ew 'xlu_cfg_get_(long|string|list|list_as_string_list)' tools/libxl/xl_cmdimpl.c | cut -f 2 -d '"' | sort -u ` do grep -wq $i docs/man/xl.cfg.pod.5 || echo $i done current output: acpi_s3 acpi_s4 cpus device_model gfx_passthru maxmem nodes sched vif2 Signed-off-by: Olaf Hering <olaf@aepfle.de> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* xl.cfg: fix gfx_passthru stringOlaf Hering2012-02-201-1/+1
| | | | | | | Use correct string for gfx_passthru, and fix comment typo in xmexample.hvm Signed-off-by: Olaf Hering <olaf@aepfle.de> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* xl: Add defaultbridge config option for xl.confStefan Bader2012-02-131-0/+6
| | | | | | | | | | | | | | Currently guests created with the xl stack will have "xenbr0" written as their default into xenstore. It can be changed in the individual guest config files, but there is no way to have that default globally changed. Add a config option to xl.conf that allows to have a different default bridge name. Signed-off-by: Stefan Bader <stefan.bader@canonical.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* libxl: Add device_model_stubdomain_seclabelDaniel De Graaf2012-02-091-0/+4
| | | | | | | | This allows the security label of stub domains to be specified. Signed-off-by: Daniel De Graaf <dgdegra@tycho.nsa.gov> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* xl: add reference for vcpu-set command.Wei Liu2012-02-091-0/+7
| | | | | Signed-off-by: Wei Liu <wei.liu2@citrix.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* xl: use json output by defaultIan Campbell2012-02-071-1/+1
| | | | | | | | | | | | | | | | | | | | | Move the sxp producing code off into a separate file. It is supported for legacy reasons and needn't be updated other than the improve compatibility with xm. libxl_domain_config is not currently generated by the IDL (adding the necessary support for Array types is on my to do list) so hand code the json generation function for now. Since this rather directly exposes a libxl data structure it's not clear what sort of forward compatibility guarantees we can make. However it seems like it should be as stable as libxl's own API (which we are looking to stabilise) (Gratuitous string.h include needed for memset in libxl_util.h) Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Acked-by: Ian Jackson <Ian.Jackson@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* xl: allow enable automatic fallback to ACPI events if PV control not available.Ian Campbell2012-01-311-4/+28
| | | | | | | | | | | | | Add a -F (fallbacks) option to xl destroy|reboot to cause an ACPI shutdown or reset event to be sent to the guest in the event that the guest does not support the PV control interface. This is not the default because the response to these triggers is an guest-internal configuration. Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Committed-by: Ian Jackson <Ian.Jackson@eu.citrix.com>
* docs: document /etc/xen/xl.confIan Campbell2012-01-311-0/+93
| | | | | | Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Committed-by: Ian Jackson <Ian.Jackson@eu.citrix.com>
* libxl: remove libxl_button_press in favour of libxl_send_trigger.Ian Campbell2012-01-311-1/+3
| | | | | | | | | | | | | send_trigger already included all the operations covered by button_press. Rework send_trigger to take an enum instead of a string. I stopped short at removing the xl "button-press" command but instead have marked it as deprecated. Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Acked-by: Ian Jackson <Ian.Jackson@eu.citrix.com> Committed-by: Ian Jackson <Ian.Jackson@eu.citrix.com>
* Tools: Add a sharing command to xl for information about shared pagesAndres Lagar-Cavilla2012-01-261-0/+13
| | | | | | | | | | | Also add the global sharing statistics to the libxl physinfo. This is a slight departure from libxc, but there's no reason libxl physinfo can't include extra bits of useful and relevant information. Signed-off-by: Andres Lagar-Cavilla <andres@lagarcavilla.org> Signed-off-by: Adin Scannell <adin@scannell.ca> Acked-by: Ian Campbell <ian.campbell@citrix.com> Committed-by: Tim Deegan <tim@xen.org>
* docs: xl.pod.1: introduction to FLASKStefano Stabellini2012-01-101-3/+17
| | | | | | | | | | | | | Add a simple introduction to FLASK to the xl man page, at the beginning of the FLASK chapter. Link to the xsm-flask.txt document. Currently FLASK, TMEM and PCI PASS-THROUGH are defined as =head2 so they look like sub-chapters of VIRTUAL DEVICE COMMANDS. Make them =head1. Based on a text written by Daniel De Graaf. Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Signed-off-by: Daniel De Graaf <dgdegra@tycho.nsa.gov> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
* libxl: report failure to reboot/shutdown due to lackof PV interfaces to callerIan Campbell2011-12-211-4/+14
| | | | | | | | | | | | This allow the caller to react as they think is appropriate. xl now prints a message much like the library did previously, although hopefully somewhat more informative. Update the xl(1) man page to be similarly more informative. Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Committed-by: Ian Jackson <ian.jackson.citrix.com> Acked-by: Ian Jackson <ian.jackson.citrix.com>
* xl.pod.1: improve documentation of FLASK commandsDaniel De Graaf2011-12-181-16/+22
| | | | Signed-off-by: Daniel De Graaf <dgdegra@tycho.nsa.gov>
* docs: Say in xm(1) that xm is obsoleteIan Jackson2011-12-081-5/+9
| | | | | Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com> Acked-by: Ian Campbell <ian.campbell@citrix.com>
* Support of xl sched-sedfJuergen Gross2011-11-281-0/+42
| | | | | | | | | | | | Supports the xl subcommand sched-sedf. The man page is only a minimal version (copy from xm man page without examples). BTW: the xm man page seems not to be in sync with xm sched-sedf -h regarding the time units. I used milliseconds in the xl implementation. Only minimal semantical checks of parameters. Signed-off-by: juergen.gross@ts.fujitsu.com Acked-by: Ian Jackson <ian.jackson.citrix.com> Committed-by: Ian Jackson <ian.jackson.citrix.com>
* Support of xl sched-credit2Juergen Gross2011-11-281-0/+29
| | | | | | | | Supports the xl subcommand sched-credit2. Signed-off-by: juergen.gross@ts.fujitsu.com Acked-by: Ian Jackson <ian.jackson.citrix.com> Committed-by: Ian Jackson <ian.jackson.citrix.com>
* Support cpupools in xl sched-creditJuergen Gross2011-11-281-0/+4
| | | | | | | | | | | | | Adds cpupool awareness to output of xl sched-credit. Output can now be restricted to a specific cpupool. The domains are printed for each cpupool seperately. The loop over cpupools and domains is seperated from the main command implementation to be able to support other schedulers as well. Signed-off-by: juergen.gross@ts.fujitsu.com Acked-by: Ian Jackson <ian.jackson.citrix.com> Committed-by: Ian Jackson <ian.jackson.citrix.com>
* xl sched-credit: support long optionsJuergen Gross2011-11-281-5/+10
| | | | | | | | | The help text of xl sched-credit supported long options. Neither the man page nor the implementation did. Signed-off-by: juergen.gross@ts.fujitsu.com Acked-by: Ian Jackson <ian.jackson.citrix.com> Committed-by: Ian Jackson <ian.jackson.citrix.com>
* xl.pod.1: add a note about autoballoon and dom0_memStefano Stabellini2011-12-011-0/+16
| | | | | Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Committed-by: Ian Jackson <Ian.Jackson@eu.citrix.com>
* xl.pod.1: add a refence to http://wiki.xen.org/xenwiki/ReportingBugsStefano Stabellini2011-12-011-1/+2
| | | | | Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Committed-by: Ian Jackson <Ian.Jackson@eu.citrix.com>
* xl.pod.1: remove AUTHORS sectionStefano Stabellini2011-12-011-7/+0
| | | | | Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Committed-by: Ian Jackson <Ian.Jackson@eu.citrix.com>
* xl.pod.1: improve description of virtual device subcommandsStefano Stabellini2011-12-011-6/+15
| | | | | | | Add a reference to xl-disk-configuration and xl-network-configuration. Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Committed-by: Ian Jackson <Ian.Jackson@eu.citrix.com>
* xl.pod.1: remove dry-run option from create and cpupool-createStefano Stabellini2011-12-011-9/+0
| | | | | | | | there is already a global dry-run option, there is no point in adding another one for each subcommand Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Committed-by: Ian Jackson <Ian.Jackson@eu.citrix.com>
* xl.pod.1: improve the description of pci-list-assignable-devicesStefano Stabellini2011-12-011-0/+3
| | | | | Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Committed-by: Ian Jackson <Ian.Jackson@eu.citrix.com>
* xl.pod.1: improve the description of the info subcommandStefano Stabellini2011-12-011-26/+29
| | | | | | | also update the example Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Committed-by: Ian Jackson <Ian.Jackson@eu.citrix.com>
* xl.pod.1: improve the debug-keys subcommand descriptionStefano Stabellini2011-12-011-1/+2
| | | | | Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Committed-by: Ian Jackson <Ian.Jackson@eu.citrix.com>