ia64/xen-unstable

changeset 4420:e9a82c51b1fc

bitkeeper revision 1.1159.170.109 (424d462b3t7TNRulCLgZcZNC5I8oew)

Added a very brief usage guide on the sedf scheduler.
author sd386@font.cl.cam.ac.uk
date Fri Apr 01 13:01:31 2005 +0000 (2005-04-01)
parents af870801ba62
children 0dc3b8b8c298
files .rootkeys docs/misc/sedf_scheduler_mini-HOWTO.txt
line diff
     1.1 --- a/.rootkeys	Thu Mar 31 23:09:27 2005 +0000
     1.2 +++ b/.rootkeys	Fri Apr 01 13:01:31 2005 +0000
     1.3 @@ -17,6 +17,7 @@ 3f9e7d60PWZJeVh5xdnk0nLUdxlqEA docs/figs
     1.4  418a3248xjIqmNKo0v_XQSfAvlBGFw docs/html.sty
     1.5  4022a73cgxX1ryj1HgS-IwwB6NUi2A docs/misc/XenDebugger-HOWTO
     1.6  412f4bd9sm5mCQ8BkrgKcAKZGadq7Q docs/misc/blkif-drivers-explained.txt
     1.7 +424d462b5GuApQ_NyMsRFt9LbrsWow docs/misc/sedf_scheduler_mini-HOWTO.txt
     1.8  40d6ccbfKKBq8jE0ula4eHEzBiQuDA docs/misc/xen_config.html
     1.9  410a4c2bAO_m_l4RsiiPHnZ4ixHWbQ docs/misc/xend.tex
    1.10  3f9e7d564bWFB-Czjv1qdmE6o0GqNg docs/src/interface.tex
     2.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     2.2 +++ b/docs/misc/sedf_scheduler_mini-HOWTO.txt	Fri Apr 01 13:01:31 2005 +0000
     2.3 @@ -0,0 +1,44 @@
     2.4 +sEDF scheduler
     2.5 +--------------
     2.6 +Author:
     2.7 +   Stephan.Diestelhorst@{cl.cam.ac.uk, inf.tu-dresden.de}
     2.8 +   
     2.9 +Overview:
    2.10 +  This scheduler provides weighted CPU sharing in an intuitive way and
    2.11 +  uses realtime-algorithms to ensure time guarantees.
    2.12 +
    2.13 +Usage:
    2.14 +   -add "sched=sedf" on Xen's boot command-line
    2.15 +   -create domains as usual
    2.16 +   -use "xm sedf <dom-id> <period> <slice> <latency-hint> <extra> <weight>"
    2.17 +    Where:
    2.18 +      -period/slice are the normal EDF scheduling parameters in nanosecs
    2.19 +      -latency-hint is the scaled period in case the domain is doing heavy I/O
    2.20 +         (unused by the currently compiled version)
    2.21 +      -extra is a flag (0/1), which controls whether the domain can run in
    2.22 +       extra-time
    2.23 +      -weight is mutually exclusive with period/slice and specifies another
    2.24 +       way of setting a domains cpu slice
    2.25 +
    2.26 +Examples:
    2.27 + normal EDF (20ms/5ms):
    2.28 +  xm sedf <dom-id> 20000000 5000000 0 0 0
    2.29 +  
    2.30 + best-effort domains (i.e. non-realtime):
    2.31 +  xm sedf <dom-id> 20000000 0 0 1 0
    2.32     2.33 + normal EDF (20ms/5ms) + share of extra-time:
    2.34 +  xm sedf <dom-id> 20000000 5000000 0 1 0
    2.35 +  
    2.36 + 4 domains with weights 2:3:4:2
    2.37 +  xm sedf <d1> 0 0 0 0 2
    2.38 +  xm sedf <d2> 0 0 0 0 3
    2.39 +  xm sedf <d3> 0 0 0 0 4
    2.40 +  xm sedf <d4> 0 0 0 0 2
    2.41 +  
    2.42 + 1 fully-specified (10ms/3ms) domain, 3 other domains share
    2.43 + available rest in 2:7:3 ratio:
    2.44 +  xm sedf <d1> 10000000 3000000 0 0 0
    2.45 +  xm sedf <d2> 0 0 0 0 2
    2.46 +  xm sedf <d3> 0 0 0 0 7
    2.47 +  xm sedf <d4> 0 0 0 0 3
    2.48 \ No newline at end of file