docs: fix documentation about default scheduler
PATCH 1/1 docs: fix documentation about default scheduler
Fix the command line document to account for the default scheduler not being credit anymore likely, and the fact that it's selectable from Kconfig and thus different builds could end up with different default schedulers.
---
Changes since v1:
- Point that the default scheduler is being selected by Kconfig, don't mention the default Kconfig selection.
--- docs/misc/xen-command-line.pandoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
docs/misc/xen-command-line.pandoc +1 -1
@@ -1876,7 +1876,7 @@ with read and write permissions. ### sched > `= credit | credit2 | arinc653 | rtds | null` -> Default: `sched=credit` +> Default: selectable via Kconfig. Depends on enabled schedulers. Choose the default scheduler.
Signature · 1 line
2.29.0
Quoted 27 lines · Roger Pau Monne
Fix the command line document to account for the default scheduler not being credit anymore likely, and the fact that it's selectable from
Kconfigand thus different builds could end up with different default schedulers.Fixes dafd936dddbd ('Make credit2 the default scheduler')Signed-off-by Roger Pau Monné <[email protected]>---
Changes since v1:
- Point that the default scheduler is being selected byKconfig, don't mention the defaultKconfigselection.
---
docs/misc/xen-command-line.pandoc | 2 +-1 file changed, 1 insertion(+), 1 deletion(-)docs/misc/xen-command-line.pandoc +0
-0@@ -1876,7 +1876,7 @@ with read and write permissions. ### schedQuoted 1 line
= credit | credit2 | arinc653 | rtds | null
Quoted 2 lines
-> Default:
sched=credit
+> Default: selectable viaKconfig. Depends on enabled schedulers.
Sorry for not weighing in earlier; but this basically makes this documentation useless.
I’d rather say:
—>8
= credit | credit2 …
Default: sched=credit2
NB that default scheduler and schedulers available can be modified via Kconfig.
8<----
-George
Quoted 24 lines · George Dunlap
Quoted 24 lines · Roger Pau Monne
Fix the command line document to account for the default scheduler not being credit anymore likely, and the fact that it's selectable from
Kconfigand thus different builds could end up with different default schedulers.Fixes dafd936dddbd ('Make credit2 the default scheduler')Signed-off-by Roger Pau Monné <[email protected]>---
Changes since v1:
- Point that the default scheduler is being selected byKconfig, don't mention the defaultKconfigselection.
---
docs/misc/xen-command-line.pandoc | 2 +-1 file changed, 1 insertion(+), 1 deletion(-)docs/misc/xen-command-line.pandoc +0
-0@@ -1876,7 +1876,7 @@ with read and write permissions. ### sched
Quoted 4 lines
Quoted 3 lines
Quoted 1 line
= credit | credit2 | arinc653 | rtds | null-> Default:
sched=credit
+> Default: selectable viaKconfig. Depends on enabled schedulers.Sorry for not weighing in earlier; but this basically makes this documentation useless.
No. It is the only half useable version, by being the only version which isn't misleading.
It would however be far better to name the CONFIG_ variable (we do elsewhere in this doc) in question so people can actually figure out what they've got in front of them.
~Andrew
Quoted 29 lines · Andrew Cooper
Quoted 24 lines · George Dunlap
Quoted 24 lines · Roger Pau Monne
Fix the command line document to account for the default scheduler not being credit anymore likely, and the fact that it's selectable from
Kconfigand thus different builds could end up with different default schedulers.Fixes dafd936dddbd ('Make credit2 the default scheduler')Signed-off-by Roger Pau Monné <[email protected]>---
Changes since v1:
- Point that the default scheduler is being selected byKconfig, don't mention the defaultKconfigselection.
---
docs/misc/xen-command-line.pandoc | 2 +-1 file changed, 1 insertion(+), 1 deletion(-)docs/misc/xen-command-line.pandoc +0
-0@@ -1876,7 +1876,7 @@ with read and write permissions. ### sched
Quoted 7 lines
Quoted 4 lines
Quoted 3 lines
Quoted 1 line
= credit | credit2 | arinc653 | rtds | null-> Default:
sched=credit
+> Default: selectable viaKconfig. Depends on enabled schedulers.Sorry for not weighing in earlier; but this basically makes this documentation useless.
No. It is the only half useable version, by being the only version which isn't misleading.
The version in this patch essentially says “This has some options, it also has a default, but we’re not going to tell you any of them, nor what your default most likely is. Go read KConfig to find out.” This is is completely useless to the person trying to figure out what the default is and what potential alternate values they can put here.
The vast majority of people who search for this on the internet will have that list of options, and have credit2=default. As long as we tell them that a local configuration can override the available options and the default, people are smart enough to figure out what their system is doing.
Quoted 3 lines
It would however be far better to name the
CONFIG_variable (we do elsewhere in this doc) in question so people can actually figure out what they've got in front of them.
Something like that would be even better, if Roger (or someone) wants to write it up.
-George
Quoted 39 lines · George Dunlap
Quoted 29 lines · Andrew Cooper
Quoted 24 lines · George Dunlap
Quoted 24 lines · Roger Pau Monne
Fix the command line document to account for the default scheduler not being credit anymore likely, and the fact that it's selectable from
Kconfigand thus different builds could end up with different default schedulers.Fixes dafd936dddbd ('Make credit2 the default scheduler')Signed-off-by Roger Pau Monné <[email protected]>---
Changes since v1:
- Point that the default scheduler is being selected byKconfig, don't mention the defaultKconfigselection.
---
docs/misc/xen-command-line.pandoc | 2 +-1 file changed, 1 insertion(+), 1 deletion(-)docs/misc/xen-command-line.pandoc +0
-0@@ -1876,7 +1876,7 @@ with read and write permissions. ### schedQuoted 7 lines
Quoted 4 lines
Quoted 3 lines
Quoted 1 line
= credit | credit2 | arinc653 | rtds | null-> Default:
sched=credit
+> Default: selectable viaKconfig. Depends on enabled schedulers.Sorry for not weighing in earlier; but this basically makes this documentation useless.
No. It is the only half useable version, by being the only version which isn't misleading.
The version in this patch essentially says “This has some options, it also has a default, but we’re not going to tell you any of them, nor what your default most likely is. Go read KConfig to find out.” This is is completely useless to the person trying to figure out what the default is and what potential alternate values they can put here.
Quoted 7 lines
The vast majority of people who search for this on the internet will have that list of options, and have credit2=default. As long as we tell them that a local configuration can override the available options and the default, people are smart enough to figure out what their system is doing.
Quoted 3 lines
It would however be far better to name the
CONFIG_variable (we do elsewhere in this doc) in question so people can actually figure out what they've got in front of them.Something like that would be even better, if Roger (or someone) wants to write it up.
I'm happy to send an updated version, but would like to have some agreement before doing so. Is the text below acceptable to everyone?
### sched
Quoted 3 lines
= credit | credit2 | arinc653 | rtds | nullDefault:
sched=credit2
Choose the default scheduler. Note the default scheduler is selectable via Kconfig and depends on enabled schedulers. Check CONFIG_SCHED_{scheduler_name}_DEFAULT when you building Xen to adjust the default scheduler.
Roger.
Quoted 51 lines · Roger Pau Monné
Quoted 39 lines · George Dunlap
Quoted 29 lines · Andrew Cooper
Quoted 24 lines · George Dunlap
Quoted 24 lines · Roger Pau Monne
Fix the command line document to account for the default scheduler not being credit anymore likely, and the fact that it's selectable from
Kconfigand thus different builds could end up with different default schedulers.Fixes dafd936dddbd ('Make credit2 the default scheduler')Signed-off-by Roger Pau Monné <[email protected]>---
Changes since v1:
- Point that the default scheduler is being selected byKconfig, don't mention the defaultKconfigselection.
---
docs/misc/xen-command-line.pandoc | 2 +-1 file changed, 1 insertion(+), 1 deletion(-)docs/misc/xen-command-line.pandoc +0
-0@@ -1876,7 +1876,7 @@ with read and write permissions. ### schedQuoted 7 lines
Quoted 4 lines
Quoted 3 lines
Quoted 1 line
= credit | credit2 | arinc653 | rtds | null-> Default:
sched=credit
+> Default: selectable viaKconfig. Depends on enabled schedulers.Sorry for not weighing in earlier; but this basically makes this documentation useless.
No. It is the only half useable version, by being the only version which isn't misleading.
The version in this patch essentially says “This has some options, it also has a default, but we’re not going to tell you any of them, nor what your default most likely is. Go read KConfig to find out.” This is is completely useless to the person trying to figure out what the default is and what potential alternate values they can put here.
Quoted 7 lines
The vast majority of people who search for this on the internet will have that list of options, and have credit2=default. As long as we tell them that a local configuration can override the available options and the default, people are smart enough to figure out what their system is doing.
Quoted 3 lines
It would however be far better to name the
CONFIG_variable (we do elsewhere in this doc) in question so people can actually figure out what they've got in front of them.Something like that would be even better, if Roger (or someone) wants to write it up.
I'm happy to send an updated version, but would like to have some agreement before doing so. Is the text below acceptable to everyone?
Quoted 7 lines
### sched
Quoted 3 lines
= credit | credit2 | arinc653 | rtds | nullDefault:
sched=credit2Choose the default scheduler. Note the default scheduler is selectable via
Kconfigand depends on enabled schedulers. Check
... CONFIG_SCHED_DEFAULT to see which scheduler is the default.
CONFIG_SCHED_{scheduler_name} specify which schedulers are available.
Juergen
Quoted 55 lines · Jürgen Groß
Quoted 54 lines · Roger Pau Monné
Quoted 39 lines · George Dunlap
Quoted 29 lines · Andrew Cooper
Quoted 24 lines · George Dunlap
Quoted 24 lines · Roger Pau Monne
Fix the command line document to account for the default scheduler not being credit anymore likely, and the fact that it's selectable from
Kconfigand thus different builds could end up with different default schedulers.Fixes dafd936dddbd ('Make credit2 the default scheduler')Signed-off-by Roger Pau Monné <[email protected]>---
Changes since v1:
- Point that the default scheduler is being selected byKconfig, don't mention the defaultKconfigselection.
---
docs/misc/xen-command-line.pandoc | 2 +-1 file changed, 1 insertion(+), 1 deletion(-)docs/misc/xen-command-line.pandoc +0
-0@@ -1876,7 +1876,7 @@ with read and write permissions. ### schedQuoted 7 lines
Quoted 4 lines
Quoted 3 lines
Quoted 1 line
= credit | credit2 | arinc653 | rtds | null-> Default:
sched=credit
+> Default: selectable viaKconfig. Depends on enabled schedulers.Sorry for not weighing in earlier; but this basically makes this documentation useless.
No. It is the only half useable version, by being the only version which isn't misleading.
The version in this patch essentially says “This has some options, it also has a default, but we’re not going to tell you any of them, nor what your default most likely is. Go read KConfig to find out.” This is is completely useless to the person trying to figure out what the default is and what potential alternate values they can put here.
Quoted 7 lines
The vast majority of people who search for this on the internet will have that list of options, and have credit2=default. As long as we tell them that a local configuration can override the available options and the default, people are smart enough to figure out what their system is doing.
Quoted 3 lines
It would however be far better to name the
CONFIG_variable (we do elsewhere in this doc) in question so people can actually figure out what they've got in front of them.Something like that would be even better, if Roger (or someone) wants to write it up.
I'm happy to send an updated version, but would like to have some agreement before doing so. Is the text below acceptable to everyone?
### sched
Quoted 1 line
= credit | credit2 | arinc653 | rtds | null
Quoted 8 lines
Quoted 4 lines
Quoted 1 line
Default:
sched=credit2Choose the default scheduler. Note the default scheduler is selectable via
Kconfigand depends on enabled schedulers. Check...
CONFIG_SCHED_DEFAULTto see which scheduler is the default.CONFIG_SCHED_{scheduler_name} specify which schedulers are available.
Hm, that's weird. When I hit help in menuconfig for the default scheduler selection it reports the option is named SCHED_{name}_DEFAULT. Will change it.
Roger.