guest/linux/paragraph/README

   1 This directory contains guest side code to use the in-progress
   2 PARAGRAPH paravirtualized graphics card within a Linux guest, either
   3 directly from a command-line testing tool or via X11.
   4
   5 It also contains information about how to build a minimal instance of
   6 X11 and then run it within a minimal guest.   This is desirable for
   7 testing.
   8
   9 README              - this file
  10
  11 write_paragraph     - manipulate PARAGRAPH from guest without X11
  12
  13 x11.patch           - modify X11 dummy driver and config files to
  14                       output to PARAGRAPH
  15
  16 x11_modified_files/ - X11 files that have been added/altered for
  17                       configuring X with PARAGRAPH (basically all
  18                       the files touched by x11.patch)
  19
  20 build_x11_minimal/  - how to actually build X11 without poking a
  21                       stick in your eye
  22
  23 run_x11_minimal/    - how to run your X11 in a tiny guest
  24                       (microcore-based)
  25
  26
  27 The level of functionality here is sufficient to bring up
  28 a basic X11 session and launch xclocks and xterms.
  29
  30 Note that some documentation refers to "x11/".  This is the
  31 built X11 image, which should be burned into a virtual disk:
  32
  33 1. Use dd to create a disk file
  34 2. Use mkfs to build a filessytem on it
  35 3. Use loopback mount to attach disk and
  36    copy your x11 setup and needed shared libraries to it.
  37 4. Unmount
  38 5. Use disk file in your Palacios guest (via FILEDISK).
  39
  40 For NU folks, this image is also sitting in /v-test/paragraph.
  41