NAME
    xend-config.sxp - Xen daemon configuration file

SYNOPSIS
    /etc/xen/xend-config.sxp

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 */etc/xen/xend-config.sxp* for details.

OPTIONS
    The following lists the daemon configuration parameters:

    *logfile*
        The location of the file to record runtime log messages. Defaults to
        */var/log/xen/xend.log*.

    *loglevel*
        Filters out messages below the specified level. Possible values are
        DEBUG, INFO, WARNING, ERROR, CRITICAL. Defaults to *DEBUG*.

    *xend-http-server*
        A boolean value that tells xend whether or not to start the http
        stream socket management server. Defaults to *no*.

    *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 CLI tools
        to operate. Defaults to *yes*.

    *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 *no*.

    *xend-unix-path*
        The location of the unix domain socket the xend-unix-server will use
        to communicate with the management tools. Defaults to
        */var/lib/xend/xend-socket*.

    *xend-port*
        The port that will be used by the http management server. Defaults
        to *8000*.

    *xend-relocation-port*
        The port that will be used by the relocation server. Defaults to
        *8002*.

    *xend-address*
        The address to which the http management server will bind. Defaults
        to *''* which means "all interfaces".

    *xend-relocation-address*
        The address to which the relocation server will bind. Defaults to
        *''* which means "all interfaces".

    *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 *1024*.

    *network-script*
        The name of the script in */etc/xen/scripts* that will be run to
        setup the networking environment. This can be any name, but in
        general is either *network-bridge* or *network-route*.

    *vif-script*
        The name of the script in */etc/xen/scripts* 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 *network-script*.

    *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.

    *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.

    *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 *no*.

    *external-migration-tool*
        The name of an application or script that can handle external device
        migration, such as for example virtual TPM migration. An example
        script is */etc/xen/scripts/external-device-migrate*.

    *device-create-timeout*
        Integer value that tells xend how long it should wait for a new
        device to be created. Defaults to *100*.

    *device-destroy-timeout*
        Integer value that tells xend how long it should wait for a device
        to be destroyed. Defaults to *100*.

EXAMPLES
    An example configuration with relocation enabled for the local network:

         (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)

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.

SEE ALSO
    xend(1)

AUTHOR
    Dan Smith <danms@us.ibm.com>

