direct-io.hg

changeset 2793:16d622cb873f

bitkeeper revision 1.1159.142.7 (418522eb75obeKEk8Kz-KPNrDom1pQ)

more doc tweaks
author smh22@tempest.cl.cam.ac.uk
date Sun Oct 31 17:37:47 2004 +0000 (2004-10-31)
parents 021cfd38c6f9
children 0b62fc951ef8 07f65861b469
files docs/src/user.tex
line diff
     1.1 --- a/docs/src/user.tex	Sun Oct 31 17:12:06 2004 +0000
     1.2 +++ b/docs/src/user.tex	Sun Oct 31 17:37:47 2004 +0000
     1.3 @@ -1,6 +1,6 @@
     1.4  \documentclass[11pt,twoside,final,openright]{xenstyle}
     1.5 -\usepackage{a4,graphicx,setspace,times}
     1.6 -\setstretch{1.15}
     1.7 +\usepackage{a4,graphicx,parskip,setspace,times}
     1.8 +\setstretch{1.1}
     1.9  
    1.10  \begin{document}
    1.11  
    1.12 @@ -49,7 +49,7 @@ Contributions of material, suggestions a
    1.13  \renewcommand{\bottomfraction}{.8}
    1.14  \renewcommand{\textfraction}{.2}
    1.15  \renewcommand{\floatpagefraction}{.8}
    1.16 -\setstretch{1.15}
    1.17 +\setstretch{1.1}
    1.18  
    1.19  \newcommand{\path}[1]{{\tt #1}}
    1.20  
    1.21 @@ -79,7 +79,7 @@ The drawback of this approach is that it
    1.22  be {\em ported} to run on Xen.  This process is similar to a port of
    1.23  an operating system to a new hardware platform, although the process
    1.24  is simplified because the paravirtual machine architecture is very
    1.25 -similar to the underlying native hardware. Although operating system
    1.26 +similar to the underlying native hardware. Even though operating system
    1.27  kernels must explicitly support Xen, a key feature is that user space
    1.28  applications and libraries {\em do not} require modification.
    1.29  
    1.30 @@ -96,18 +96,18 @@ Possible usage scenarios for Xen include
    1.31        machine.
    1.32  \item [Multiple OS configurations.] Run multiple operating systems
    1.33        simultaneously, for instance for compatibility or QA purposes.
    1.34 -\item [Server consolidation.] Move multiple servers onto one box,
    1.35 -      provided performance and fault isolation at virtual machine
    1.36 -      boundaries.
    1.37 +\item [Server consolidation.] Move multiple servers onto one box
    1.38 +      with performance and fault isolation provided at virtual machine
    1.39 +      boundaries. 
    1.40  \item [Cluster computing.] Improve manageability and efficiency by
    1.41        running services in virtual machines, isolated from
    1.42 -      machine-specifics and load balance using live migration.
    1.43 +      machine-specifics; load balance using live migration.
    1.44  \item [High availability computing.] Run device drivers in sandboxed
    1.45        domains for increased robustness.
    1.46  \item [Hardware support for custom OSes.] Export drivers from a
    1.47 -      mainstream OS (e.g. Linux) with good hardware support
    1.48 +      mainstream OS (e.g. Linux) with wide-ranging hardware support
    1.49        to your custom OS, avoiding the need for you to port existing
    1.50 -      drivers to achieve good hardware support.
    1.51 +      drivers.
    1.52  \end{description}
    1.53  
    1.54  \section{Structure of a Xen-Based System}
    1.55 @@ -126,15 +126,15 @@ other domains and manages their virtual 
    1.56  suspend, resume and migration of virtual machines. Where one is
    1.57  required, the X server is also run in domain 0.
    1.58  
    1.59 -Within Domain 0, a process called `Xend' runs to manage the system.
    1.60 +Within Domain 0, a process called `xend' runs to manage the system.
    1.61  Xend is responsible for managing virtual machines and providing access
    1.62  to their consoles.  Commands are issued to Xend over an HTTP
    1.63  interface, either from a command-line tool or from a web browser.
    1.64  
    1.65  \section{Hardware Support}
    1.66  
    1.67 -Xen currently runs only on the x86 architecture (however, ports to other
    1.68 -architectures, including x86/64 and IA64, are in progress).
    1.69 +Xen currently runs only on the x86 architecture, although ports to other
    1.70 +architectures, including x86/64 and IA64, are in progress.
    1.71  Xen requires a `P6' or newer processor (e.g. Pentium Pro, Celeron,
    1.72  Pentium II, Pentium III, Pentium IV, Xeon, AMD Athlon, AMD Duron).
    1.73  Multiprocessor machines are supported, and we also have basic support
    1.74 @@ -146,7 +146,7 @@ mode.
    1.75  Xen can currently use up to 4GB of memory.  It is possible for x86
    1.76  machines to address up to 64GB of physical memory but there are no
    1.77  plans to support these systems.  The x86\_64 port is the planned route
    1.78 -to supporting more than 4GB of memory.
    1.79 +to supporting larger memory sizes. 
    1.80  
    1.81  Xen offloads most of the hardware support issues to the guest OS
    1.82  running in Domain 0.  Xen itself only contains code to detect and
    1.83 @@ -186,7 +186,7 @@ first public release (1.0) was made in O
    1.84  then, Xen has been extensively developed and is now used in production
    1.85  scenarios on multiple sites.
    1.86  
    1.87 -Xen 2.0 feature greatly enhanced hardware support, configuration
    1.88 +Xen 2.0 features greatly enhanced hardware support, configuration
    1.89  flexibility, usability and a larger complement of supported operating
    1.90  systems. This latest release takes Xen a step closer to becoming the 
    1.91  definitive open source solution for virtualisation.
    1.92 @@ -209,7 +209,7 @@ operating system distribution.
    1.93  \item A working installation of the GRUB bootloader.
    1.94  \item An installation of Twisted v1.3 or above (see {\tt
    1.95  http://www.twistedmatrix.com}).  There may be a package available for
    1.96 -your distribution; alternatively it can be installed by running {\tt \#
    1.97 +your distribution; alternatively it can be installed by running {\tt
    1.98  make install-twisted} in the root of the Xen source tree.
    1.99  \item Python logging package (see {\tt http://www.red-dove.com/})
   1.100  \item The Linux bridge control tools (see {\tt
   1.101 @@ -228,9 +228,11 @@ available for your distribution.
   1.102  \section{Install Bitkeeper (Optional)}
   1.103  
   1.104  To fetch a local copy, first download the BitKeeper tools.
   1.105 -Download instructions must be obtained by filling out the provided
   1.106 -form at: \\ {\tt
   1.107 -http://www.bitmover.com/cgi-bin/download.cgi }
   1.108 +Download instructions can be obtained by filling out the provided
   1.109 +form at: 
   1.110 +\begin{quote} 
   1.111 +{\tt http://www.bitmover.com/cgi-bin/download.cgi}
   1.112 +\end{quote}
   1.113  
   1.114  The BitKeeper install program is designed to be run with X.  If X is
   1.115  not available, you can specify the install directory on the command
   1.116 @@ -240,8 +242,11 @@ line.
   1.117  
   1.118  \subsection{Using Bitkeeper}
   1.119  
   1.120 -The public master BK repository for the 2.0 release lives at: \\
   1.121 -{\tt bk://xen.bkbits.net/xen-2.0.bk}.  You can use Bitkeeper to
   1.122 +The public master BK repository for the 2.0 release lives at: 
   1.123 +\begin{quote}
   1.124 +{\tt bk://xen.bkbits.net/xen-2.0.bk}  
   1.125 +\end{quote} 
   1.126 +You can use Bitkeeper to
   1.127  download it and keep it updated with the latest features and fixes.
   1.128  
   1.129  Change to the directory in which you want to put the source code, then
   1.130 @@ -250,6 +255,7 @@ run:
   1.131  # bk clone bk://xen.bkbits.net/xen-2.0.bk
   1.132  \end{verbatim}
   1.133  
   1.134 +
   1.135  Under your current directory, a new directory named `xen-2.0.bk' has
   1.136  been created, which contains all the source code for the Xen
   1.137  hypervisor and the Xen tools.  The directory also contains `sparse' OS
   1.138 @@ -268,7 +274,8 @@ changes to the repository by running:
   1.139  The Xen source tree is also available in gzipped tarball form from the
   1.140  Xen downloads page:\\
   1.141  {\tt http://www.cl.cam.ac.uk/Research/SRG/netos/xen/downloads.html}.
   1.142 -Prebuilt tarballs are also available from this page but are very large.
   1.143 +Prebuilt tarballs are also available from this page but are relatively
   1.144 + large.
   1.145  
   1.146  \section{The distribution}
   1.147