Re: [RESEND PATCH v5 5/5] Documentation/vmcoreinfo: Add documentation for 'TCR_EL1.T1SZ'
From: James Morse <james.morse@arm.com>
Date: 2019-12-12 10:32:44
Also in:
kexec, linux-arm-kernel, linux-doc, lkml
Hi Bhupesh, On 29/11/2019 19:59, Bhupesh Sharma wrote:
Add documentation for TCR_EL1.T1SZ variable being added to vmcoreinfo. It indicates the size offset of the memory region addressed by TTBR1_EL1
and hence can be used for determining the vabits_actual value.
used for determining random-internal-kernel-variable, that might not exist tomorrow. Could you describe how this is useful/necessary if a debugger wants to walk the page tables from the core file? I think this is a better argument. Wouldn't the documentation be better as part of the patch that adds the export? (... unless these have to go via different trees? ..)
quoted hunk ↗ jump to hunk
diff --git a/Documentation/admin-guide/kdump/vmcoreinfo.rst b/Documentation/admin-guide/kdump/vmcoreinfo.rst index 447b64314f56..f9349f9d3345 100644 --- a/Documentation/admin-guide/kdump/vmcoreinfo.rst +++ b/Documentation/admin-guide/kdump/vmcoreinfo.rst@@ -398,6 +398,12 @@ KERNELOFFSET The kernel randomization offset. Used to compute the page offset. If KASLR is disabled, this value is zero. +TCR_EL1.T1SZ +------------ + +Indicates the size offset of the memory region addressed by TTBR1_EL1
+and hence can be used for determining the vabits_actual value.
'vabits_actual' may not exist when the next person comes to read this documentation (its going to rot really quickly). I think the first half of this text is enough to say what this is for. You should include words to the effect that its the hardware value that goes with swapper_pg_dir. You may want to point readers to the arm-arm for more details on what the value means. Thanks, James