KGDB documentation [Re: [discuss] KGDB 2.0.3 with fixes and development in ethernet interface]

["Amit S. Kale" <amitkale@emsyssoft.com>]

Hi All,

I extracted this part of Pavel the patch he had submitted for 2.0.3 and 
appended it to README file. Since Pavel has't noticed it, I am assuming that 
most people won't notice it either.

Do people think pushing documentation into Documentation/kgdb directory is a 
better idea?

Another note about kgdb documentation - 
There is a lot of documentation at kgdb.sourceforge.net. It's more of howto 
type rather than manpages. Will it be too much as a documentation in kernel 
sources.

Any ideas on which things to put into Documentation/kgdb and which to have on 
a website.

On Friday 16 Jan 2004 9:22 pm, Pavel Machek wrote:
> Hi!
>
> > > int kgdbeth_event(struct notifier_block * self, unsigned long val,
> > > void * data)
> > > {
> > >         if (strcmp(((struct net_device *)data)->name, "eth0")) {
> > >                 goto out;
> > >         }
> > >         if (val!= NETDEV_UP)
> > >                 goto out;
> > >
> > > Do I read it correctly as "eth0 is not to be used for debugging"? So
> > > if I only have eth0 here, I have to comment it out, right?
> >
> > No. It uses only "eth0" for debugging. If you have only eth0, it'll use
> > that for debugging.
>
> Perhaps this is good idea? It should be documented
> somewhere... Please apply,
> 								Pavel
>
> --- /dev/null	2003-09-12 10:38:14.000000000 +0200
> +++ linux/Documentation/kgdb/ethernet.txt	2004-01-16 16:43:34.000000000
> +0100 @@ -0,0 +1,15 @@
> +Some notes about kgdb over ethernet
> +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> +
> + 2004 Pavel Machek <pavel@suse.cz>
> +
> +Pass this on kernel commandline:
> +
> +	kgdbeth=interfacenum,localmac,listenport,remoteip,remotemac gdb
> +
> +Boot local machine. At the point where you enable eth0, machine will
> +hang, waiting for remote gdb to connect. At that point, type this on
> +remote machine:
> +
> +   $ gdb ./vmlinux
> +   (gdb) target remote udp:HOSTNAME:6443

-- 
Amit Kale
EmSysSoft (http://www.emsyssoft.com)
KGDB: Linux Kernel Source Level Debugger (http://kgdb.sourceforge.net)