Skip to content

manual: don't list out all MSRs and VMCS fields#515

Open
dreamliner787-9 wants to merge 1 commit into
seL4:mainfrom
au-ts:manual_update
Open

manual: don't list out all MSRs and VMCS fields#515
dreamliner787-9 wants to merge 1 commit into
seL4:mainfrom
au-ts:manual_update

Conversation

@dreamliner787-9

@dreamliner787-9 dreamliner787-9 commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

The kernel now permits userspace to read IA32_VMX_MISC_MSR MSR to operate the VMX preemption timer in commit 7441046. This commit updates the manual to reflect that. Since the seL4 version in Microkit had been recently bumped which included that commit.

The previous approach is too unwieldy and required constant updates.
We should just link the user to the kernel instead and have one
source of truth.

@dreamliner787-9 dreamliner787-9 changed the title Manual update manual: update list of writable MSRs for x86 VCPU Jun 4, 2026

@midnightveil midnightveil left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IDK why we need a long list of everything supported tbh.

@midnightveil

Copy link
Copy Markdown
Collaborator

Actually, yeah. I think I changed my mind. I'm guessing there's an x86 reference for these registers? I don't think we should list all of them here, it's unwieldy.

@dreamliner787-9

Copy link
Copy Markdown
Contributor Author

You could consult the Intel SDM, but the kernel doesn't allow you to read/write to all of the fields. So I thought it would be best if we list out which fields the user can touch.

@midnightveil

Copy link
Copy Markdown
Collaborator

I think we should do something along the lines of "seL4 only allows certain MSRs to be written by userspace; for a full list of supported ones, see ".

@dreamliner787-9 dreamliner787-9 changed the title manual: update list of writable MSRs for x86 VCPU manual: don't list out all MSRs and VMCS fields Jun 10, 2026

@midnightveil midnightveil left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It might be worth making it so that seL4 documents this somewhere outside of the source, so that we don't have to link there, but this is good enough for now.

The previous approach is too unwieldy and required constant updates.
We should just link the user to the kernel instead and have one
source of truth.

Signed-off-by: Bill Nguyen <bill.nguyen@unsw.edu.au>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants