From 26937cc1116c56f405640e6988f64089fd260cdb Mon Sep 17 00:00:00 2001 From: "dan@localhost.localdomain" Date: Sun, 20 Nov 2005 15:01:15 +0100 Subject: First stab at a xend-config.sxp man page. --- docs/man/xend-config.sxp.pod.5 | 142 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 142 insertions(+) create mode 100644 docs/man/xend-config.sxp.pod.5 (limited to 'docs/man/xend-config.sxp.pod.5') diff --git a/docs/man/xend-config.sxp.pod.5 b/docs/man/xend-config.sxp.pod.5 new file mode 100644 index 0000000000..a11db8cfde --- /dev/null +++ b/docs/man/xend-config.sxp.pod.5 @@ -0,0 +1,142 @@ +=head1 NAME + +xend-config.sxp - Xen daemon configuration file + +=head1 SYNOPSIS + +/etc/xen/xend-config.sxp + +=head1 DESCRIPTION + +The xend(1) program requires xend-config.sxp to specify operating +parameters which determine the behavior of the daemon at runtime. + +The parameters are specified in S-expression format. See the example +configuration file in I for details. + +=head1 OPTIONS + +The following lists the daemon configuration parameters: + +=over 4 + +=item I + +The location of the file to record runtime log messages. Defaults to +I. + +=item I + +Filters out messages below the specified level. Possible values are +DEBUG, INFO, WARNING, ERROR, CRITICAL. Defaults to I. + +=item I + +A boolean value that tells xend whether or not to start the http +stream socket management server. Defaults to I. + +=item I + +A boolean value that tells xend whether or not to start the unix +domain socket management server. This is required for the CLI tools +to operate. Defaults to I. + +=item I + +A boolean value that tells xend whether or not to start the relocation +server. This is required for cross-machine migrations. Defaults to +I. + +=item I + +The location of the unix domain socket the xend-unix-server will use +to communicate with the management tools. Defaults to +I. + +=item I + +The port that will be used by the http management server. Defaults to +I<8000>. + +=item I + +The port that will be used by the relocation server. Defaults to +I<8002>. + +=item I + +The address to which the http management server will bind. Defaults +to I<''> which means "all interfaces". + +=item I + +The address to which the relocation server will bind. Defaults to +I<''> which means "all interfaces". + +=item I + +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 I<1024>. + +=item I + +The name of the script in I that will be run to +setup the networking environment. This can be any name, but in +general is either I or I. + +=item I + +The name of the script in I 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 I. + +=item I + +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. + +=item I + +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. + +=item I + +A boolean value that tells xend whether or not core dumps of guest +domains should be saved when a crash occurrs. Defaults to I. + +=back + +=head1 EXAMPLES + +An example configuration with relocation enabled for the local network: + +=over 4 + + (xend-relocation-server yes) + (xend-relocation-address 192.168.1.1) + (network-script network-bridge) + (vif-script vif-bridge) + (dom0-min-mem 0) + (dom0-cpus 0) + +=back + +=head1 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. + +=head1 SEE ALSO + +B(1) + +=head1 AUTHOR + +Dan Smith + -- cgit v1.2.3