Re: [PATCH] Kdump documentation update for 2.6.20

Previous thread: [PATCH] kernel-doc: allow more whitespace by Randy Dunlap on Sunday, January 7, 2007 - 11:15 pm. (1 message)

Next thread: Re: [PATCH libata #promise-sata-pata] sata_promise: unbreak 20619 by Mikael Pettersson on Monday, January 8, 2007 - 1:07 am. (1 message)
From: Vivek Goyal
Date: Monday, January 8, 2007 - 12:58 am

o Kdump documentation update.
	- Update details for using relocatable kernel.
	- Start using kexec-tools-testing release as it is latest and old
	  kexec-tools can't load relocatable bzImage file.

Signed-off-by: Vivek Goyal <vgoyal@in.ibm.com>
---

 Documentation/kdump/kdump.txt |  160 ++++++++++++++++++++++++++++++++++--------
 1 file changed, 130 insertions(+), 30 deletions(-)

diff -puN Documentation/kdump/kdump.txt~kdump-documentation-update Documentation/kdump/kdump.txt
--- linux-2.6.20-rc2-mm1-reloc/Documentation/kdump/kdump.txt~kdump-documentation-update	2007-01-08 10:01:50.000000000 +0530
+++ linux-2.6.20-rc2-mm1-reloc-root/Documentation/kdump/kdump.txt	2007-01-08 11:51:49.000000000 +0530
@@ -54,56 +54,68 @@ memory," in two ways:
 Setup and Installation
 ======================
 
-Install kexec-tools and the Kdump patch
----------------------------------------
+Install kexec-tools
+-------------------
 
 1) Login as the root user.
 
 2) Download the kexec-tools user-space package from the following URL:
 
-   http://www.xmission.com/~ebiederm/files/kexec/kexec-tools-1.101.tar.gz
+http://www.kernel.org/pub/linux/kernel/people/horms/kexec-tools/kexec-tools-testing-20061214.tar.gz
 
-3) Unpack the tarball with the tar command, as follows:
-
-   tar xvpzf kexec-tools-1.101.tar.gz
-
-4) Download the latest consolidated Kdump patch from the following URL:
-
-   http://lse.sourceforge.net/kdump/
+Note: Latest kexec-tools-testing git tree is available at
 
-   (This location is being used until all the user-space Kdump patches
-   are integrated with the kexec-tools package.)
+git://git.kernel.org/pub/scm/linux/kernel/git/horms/kexec-tools-testing.git
+or
+http://www.kernel.org/git/?p=linux/kernel/git/horms/kexec-tools-testing.git;a=summary
 
-5) Change to the kexec-tools-1.101 directory, as follows:
+3) Unpack the tarball with the tar command, as follows:
 
-   cd kexec-tools-1.101
+   tar xvpzf kexec-tools-testing-20061214.tar.gz
 
-6) Apply the ...
From: Horms
Date: Monday, January 8, 2007 - 6:18 pm

I think that the above description is a little misleading, and quite
i386 centric. The question is not weather or not you are using the
system kernel, but rather, what options are needed for the crash kernel.

In terms of a non-relocatable kernel, then the boot and crash kernels
need to be separate.

But in the case of a relocatable kernel, then the boot and crash kernels
may be the same, or they may be separate. Depending on just what
the end-user wants in each kernel.

On ia64 there is no CONFIG_RELOCATABLE option, but the kernel is always
relocatable anyway. That is, you can use the same kernel before and
after crash (though I am not sure that I have tested this).

I'm not sure about ppc64.

I think that the description of how to build the kernels also needs to
be reworked a little to reflect this. Perhaps you could divide the
methods based on vmlinuz/bzImage, rather than
non-relocatable/relocatable (or custom kernel/system kernel?). It seems
that it is the former, rather than the later that has impact on how

--args-linux is not needed on ia64, but its kernel is relocatable.
I think the important point is that if you are using a bzImage,
then you need --args-linux, and basically at this point that
means an i386 (or x86_64) relocatable bzImage.

Then again, I could be wrong, I'm not sure that I understand

-- 
Horms
  H: http://www.vergenet.net/~horms/
  W: http://www.valinux.co.jp/en/

-

From: Vivek Goyal
Date: Tuesday, January 9, 2007 - 7:47 am

Hi Horms,

Thanks for going through the update. Actually I never knew that kdump
IA64 support is mainline now. I thought it is still in Tony's tree. And
we never had IA64 specific documentation in kdump.txt file and that's another
reason that discussion became more i386 centric when it came to relocatable

I have tried to re-arrange the documentation based on some of your 
recommendations. I have also left couple of sections empty which are
ia64 specific. I don't have an IA64 machine and I don't know how exactly
it is used on IA64. Can you please have a quick look at the patch and
also fill IA64 specific details where appropriate.

Hopefully, this time documentation is clearer.



I am hoping it --args-linux will be required while loading vmlinux on
IA64? Because this is ELF file specific option. And this interface should


Thanks
Vivek


o Kdump documentation update.
	- Update details for using relocatable kernel.
	- Start using kexec-tools-testing release as it is latest and old
	  kexec-tools can't load relocatable bzImage file.
	- Also add kdump on ia64 specific details.

Signed-off-by: Vivek Goyal <vgoyal@in.ibm.com>
---

 Documentation/kdump/kdump.txt |  221 +++++++++++++++++++++++++++++-------------
 1 file changed, 153 insertions(+), 68 deletions(-)

diff -puN Documentation/kdump/kdump.txt~kdump-documentation-update Documentation/kdump/kdump.txt
--- linux-2.6.20-rc2-mm1-reloc/Documentation/kdump/kdump.txt~kdump-documentation-update	2007-01-08 12:32:55.000000000 +0530
+++ linux-2.6.20-rc2-mm1-reloc-root/Documentation/kdump/kdump.txt	2007-01-09 19:57:06.000000000 +0530
@@ -17,7 +17,7 @@ You can use common Linux commands, such 
 memory image to a dump file on the local disk, or across the network to
 a remote system.
 
-Kdump and kexec are currently supported on the x86, x86_64, and ppc64
+Kdump and kexec are currently supported on the x86, x86_64, ppc64 and IA64
 architectures.
 
 When the system kernel boots, it reserves a small section of memory for
@@ ...
From: Horms
Date: Tuesday, January 9, 2007 - 5:31 pm

I will take a look into this.

-- 
Horms
  H: http://www.vergenet.net/~horms/
  W: http://www.valinux.co.jp/en/

-

From: Zou, Nanhai
Date: Tuesday, January 9, 2007 - 6:34 pm

args-linux is not support by IA64 kdump. 
To have common interface, maybe we should support it by ignore this arg like ppc does.

-

From: Horms
Date: Tuesday, January 9, 2007 - 6:53 pm

That sounds reasonable to me. Vivek, what do you think?

-- 
Horms
  H: http://www.vergenet.net/~horms/
  W: http://www.valinux.co.jp/en/

-

From: Vivek Goyal
Date: Tuesday, January 9, 2007 - 9:43 pm

I think we should recognize --args-linux while loading elf image and
all the processing we do for loading linux elf vmlinux should be done
under that option (The way i386 does). This will help if down the line
kexec ia64 loader allows loading some other elf images where one needs
to prepare elf boot notes (--args-elf). 

Eric is the best person to comment on this. He has got all the background
about these options.

Thanks
Vivek
-

From: Mohan Kumar M
Date: Tuesday, January 9, 2007 - 10:37 pm

Vivek,

It is not true, kdump on ppc64 works with NUMA and EEH enabled. So the
user need not disable NUMA and enable EMBEDDED support to make kdump

Should we mention the above paragraph?
Why can not we specify by default PPC64 kdump kernel is loaded at 32MB?

Regards,
Mohan.
-

From: Vivek Goyal
Date: Wednesday, January 10, 2007 - 2:15 am

Thanks Mohan. I have updated the document as per your feedback.

Please find attached the latest patch.

Thanks
Vivek


o Kdump documentation update.
	- Update details for using relocatable kernel.
	- Start using kexec-tools-testing release as it is latest and old
	  kexec-tools can't load relocatable bzImage file.
	- Also add kdump on ia64 specific details.

Signed-off-by: Vivek Goyal <vgoyal@in.ibm.com>
---

 Documentation/kdump/kdump.txt |  224 ++++++++++++++++++++++++++++--------------
 1 file changed, 152 insertions(+), 72 deletions(-)

diff -puN Documentation/kdump/kdump.txt~kdump-documentation-update Documentation/kdump/kdump.txt
--- linux-2.6.20-rc2-mm1-reloc/Documentation/kdump/kdump.txt~kdump-documentation-update	2007-01-08 12:32:55.000000000 +0530
+++ linux-2.6.20-rc2-mm1-reloc-root/Documentation/kdump/kdump.txt	2007-01-10 14:38:58.000000000 +0530
@@ -17,7 +17,7 @@ You can use common Linux commands, such 
 memory image to a dump file on the local disk, or across the network to
 a remote system.
 
-Kdump and kexec are currently supported on the x86, x86_64, and ppc64
+Kdump and kexec are currently supported on the x86, x86_64, ppc64 and IA64
 architectures.
 
 When the system kernel boots, it reserves a small section of memory for
@@ -54,59 +54,64 @@ memory," in two ways:
 Setup and Installation
 ======================
 
-Install kexec-tools and the Kdump patch
----------------------------------------
+Install kexec-tools
+-------------------
 
 1) Login as the root user.
 
 2) Download the kexec-tools user-space package from the following URL:
 
-   http://www.xmission.com/~ebiederm/files/kexec/kexec-tools-1.101.tar.gz
+http://www.kernel.org/pub/linux/kernel/people/horms/kexec-tools/kexec-tools-testing-20061214.tar.gz
 
-3) Unpack the tarball with the tar command, as follows:
-
-   tar xvpzf kexec-tools-1.101.tar.gz
-
-4) Download the latest consolidated Kdump patch from the following URL:
-
-   http://lse.sourceforge.net/kdump/
+Note: Latest ...
From: Horms
Date: Thursday, January 11, 2007 - 1:13 am

This seems like a great improvement on the existing document.
Lets get this in the tree and make any further changes from there.
I'll send a patch to add the ia64 details shortly.


-- 
Horms
  H: http://www.vergenet.net/~horms/
  W: http://www.valinux.co.jp/en/

-

Previous thread: [PATCH] kernel-doc: allow more whitespace by Randy Dunlap on Sunday, January 7, 2007 - 11:15 pm. (1 message)

Next thread: Re: [PATCH libata #promise-sata-pata] sata_promise: unbreak 20619 by Mikael Pettersson on Monday, January 8, 2007 - 1:07 am. (1 message)