.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "xend-config.sxp 5" .TH xend-config.sxp 5 "2013-01-22" "xen-unstable" "Xen" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" xend\-config.sxp \- Xen daemon configuration file .SH "SYNOPSIS" .IX Header "SYNOPSIS" /etc/xen/xend\-config.sxp .SH "DESCRIPTION" .IX Header "DESCRIPTION" The \fIxend\fR\|(1) program requires xend\-config.sxp to specify operating parameters which determine the behavior of the daemon at runtime. .PP The parameters are specified in S\-expression format. See the example configuration file in \fI/etc/xen/xend\-config.sxp\fR for details. .SH "OPTIONS" .IX Header "OPTIONS" The following lists the daemon configuration parameters: .IP "\fIlogfile\fR" 4 .IX Item "logfile" The location of the file to record runtime log messages. Defaults to \&\fI/var/log/xen/xend.log\fR. .IP "\fIloglevel\fR" 4 .IX Item "loglevel" Filters out messages below the specified level. Possible values are \&\s-1DEBUG\s0, \s-1INFO\s0, \s-1WARNING\s0, \s-1ERROR\s0, \s-1CRITICAL\s0. Defaults to \fI\s-1DEBUG\s0\fR. .IP "\fIxend-http-server\fR" 4 .IX Item "xend-http-server" A boolean value that tells xend whether or not to start the http stream socket management server. Defaults to \fIno\fR. .IP "\fIxend-unix-server\fR" 4 .IX Item "xend-unix-server" A boolean value that tells xend whether or not to start the unix domain socket management server. This is required for the \s-1CLI\s0 tools to operate. Defaults to \fIyes\fR. .IP "\fIxend-relocation-server\fR" 4 .IX Item "xend-relocation-server" A boolean value that tells xend whether or not to start the relocation server. This is required for cross-machine migrations. Defaults to \&\fIno\fR. .IP "\fIxend-unix-path\fR" 4 .IX Item "xend-unix-path" The location of the unix domain socket the xend-unix-server will use to communicate with the management tools. Defaults to \&\fI/var/lib/xend/xend\-socket\fR. .IP "\fIxend-port\fR" 4 .IX Item "xend-port" The port that will be used by the http management server. Defaults to \&\fI8000\fR. .IP "\fIxend-relocation-port\fR" 4 .IX Item "xend-relocation-port" The port that will be used by the relocation server. Defaults to \&\fI8002\fR. .IP "\fIxend-address\fR" 4 .IX Item "xend-address" The address to which the http management server will bind. Defaults to \fI''\fR which means \*(L"all interfaces\*(R". .IP "\fIxend-relocation-address\fR" 4 .IX Item "xend-relocation-address" The address to which the relocation server will bind. Defaults to \&\fI''\fR which means \*(L"all interfaces\*(R". .IP "\fIconsole-limit\fR" 4 .IX Item "console-limit" The kilobyte buffer limit that will be enforced by the console server. This limit is set per-domain, and is needed to prevent a single domain from overwhelming the console server with massive amounts of data. Defaults to \fI1024\fR. .IP "\fInetwork-script\fR" 4 .IX Item "network-script" The name of the script in \fI/etc/xen/scripts\fR that will be run to setup the networking environment. This can be any name, but in general is either \fInetwork-bridge\fR or \fInetwork-route\fR. .IP "\fIvif-script\fR" 4 .IX Item "vif-script" The name of the script in \fI/etc/xen/scripts\fR that will be run to setup a virtual interface when it is created or destroyed. This needs to (in general) work in unison with the \fInetwork-script\fR. .IP "\fIdom0\-min\-mem\fR" 4 .IX Item "dom0-min-mem" This specifies the minimum number of megabytes that will be reserved for Domain0. If this value is positive, Domain0 will be automatically ballooned down to this limit to make space for new domains. If this is set to 0, Domain0 will not be automatically ballooned. .IP "\fIdom0\-cpus\fR" 4 .IX Item "dom0-cpus" This specifies the number of CPUs that Domain0 will be allowed to use. If the value is 0, all available CPUs will be used by Domain0. .IP "\fIenable-dump\fR" 4 .IX Item "enable-dump" A boolean value that tells xend whether or not core dumps of guest domains should be saved when a crash occurs. Defaults to \fIno\fR. .IP "\fIexternal-migration-tool\fR" 4 .IX Item "external-migration-tool" The name of an application or script that can handle external device migration, such as for example virtual \s-1TPM\s0 migration. An example script is \fI/etc/xen/scripts/external\-device\-migrate\fR. .IP "\fIdevice-create-timeout\fR" 4 .IX Item "device-create-timeout" Integer value that tells xend how long it should wait for a new device to be created. Defaults to \fI100\fR. .IP "\fIdevice-destroy-timeout\fR" 4 .IX Item "device-destroy-timeout" Integer value that tells xend how long it should wait for a device to be destroyed. Defaults to \fI100\fR. .SH "EXAMPLES" .IX Header "EXAMPLES" An example configuration with relocation enabled for the local network: .Sp .Vb 6 \& (xend\-relocation\-server yes) \& (xend\-relocation\-address 192.0.2.192) \& (network\-script network\-bridge) \& (vif\-script vif\-bridge) \& (dom0\-min\-mem 0) \& (dom0\-cpus 0) .Ve .SH "CAVEATS" .IX Header "CAVEATS" Note that relocation is currently unsecured and is very dangerous if left enabled. No authentication is performed, and very little sanity checking takes place. Enable at your own risk. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBxend\fR(1) .SH "AUTHOR" .IX Header "AUTHOR" Dan Smith