Re: [patch 6/7] Linux Kernel Markers - Documentation

[Mathieu Desnoyers]

* Randy Dunlap (randy.dunlap@xxxxxxxxxx) wrote:
> On Mon, 24 Sep 2007 17:08:30 -0400 Mathieu Desnoyers wrote:
> 
> > * Randy Dunlap (randy.dunlap@xxxxxxxxxx) wrote:
> > > On Mon, 24 Sep 2007 11:56:35 -0700 Randy Dunlap wrote:
> > > 
> > > > Christoph Hellwig wrote:
> > > > > On Mon, Sep 24, 2007 at 11:49:15AM -0700, Randy Dunlap wrote:
> > > > >> I think that samples are perfectly fine for documentation and
> > > > >> that the trace example is a good example.  I think that most people
> > > > >> who need something like that would need to customize it for their
> > > > >> specific needs anyway.
> > > > >>
> > > > >> We don't seem to be making progress...
> > > > > 
> > > > > Time to bring in a Tie-Breaker :)
> > > > 
> > > > Yes.  Is anyone else interested?   :(
> > > 
> > > 
> > > I guess that's everyone (except those who are sleeping).
> > > 
> > > Let's not hold up progress.  Just use samples/ for code.
> > 
> > Would you already have the 
> > 
> > Makefile
> > samples/Kconfig
> > samples/Makefile
> > 
> > core code handy per chance ? (and probably Kconfig sourcing in every
> > arch ?)
> 
> Yes.  Here it is.  I'm working on add kprobes to it, but you
> can go ahead with markers also.
> 
> 

Hi Randy,

I got everything working and I'm thinking about posting all this stuff
soon. Do you think your patch (having renamed Kbuild to Makefile) is
ready to post ?

Mathieu

> 
> From: Randy Dunlap <randy.dunlap@xxxxxxxxxx>
> 
> Begin infrastructure for kernel code samples in the samples/ directory.
> Add its Kconfig and Kbuild files.
> Source its Kconfig file in all arch/ Kconfigs.
> 
> 
> Signed-off-by: Randy Dunlap <randy.dunlap@xxxxxxxxxx>
> ---
>  Makefile               |   10 +++++++---
>  arch/alpha/Kconfig     |    2 ++
>  arch/arm/Kconfig       |    2 ++
>  arch/avr32/Kconfig     |    2 ++
>  arch/blackfin/Kconfig  |    2 ++
>  arch/cris/Kconfig      |    2 ++
>  arch/frv/Kconfig       |    2 ++
>  arch/h8300/Kconfig     |    2 ++
>  arch/i386/Kconfig      |    2 ++
>  arch/ia64/Kconfig      |    2 ++
>  arch/m32r/Kconfig      |    2 ++
>  arch/m68k/Kconfig      |    2 ++
>  arch/m68knommu/Kconfig |    2 ++
>  arch/mips/Kconfig      |    2 ++
>  arch/parisc/Kconfig    |    2 ++
>  arch/powerpc/Kconfig   |    2 ++
>  arch/ppc/Kconfig       |    2 ++
>  arch/s390/Kconfig      |    2 ++
>  arch/sh/Kconfig        |    2 ++
>  arch/sh64/Kconfig      |    2 ++
>  arch/sparc/Kconfig     |    2 ++
>  arch/sparc64/Kconfig   |    2 ++
>  arch/um/Kconfig        |    2 ++
>  arch/v850/Kconfig      |    2 ++
>  arch/x86_64/Kconfig    |    2 ++
>  arch/xtensa/Kconfig    |    3 ++-
>  samples/Kbuild         |    2 ++
>  samples/Kconfig        |   11 +++++++++++
>  28 files changed, 70 insertions(+), 4 deletions(-)
> 
> --- linux-2.6.23-rc7.orig/Makefile
> +++ linux-2.6.23-rc7/Makefile
> @@ -436,6 +436,7 @@ drivers-y	:= drivers/ sound/
>  net-y		:= net/
>  libs-y		:= lib/
>  core-y		:= usr/
> +samples-y	:= samples/
>  endif # KBUILD_EXTMOD
>  
>  ifeq ($(dot-config),1)
> @@ -564,10 +565,12 @@ core-y		+= kernel/ mm/ fs/ ipc/ security
>  
>  vmlinux-dirs	:= $(patsubst %/,%,$(filter %/, $(init-y) $(init-m) \
>  		     $(core-y) $(core-m) $(drivers-y) $(drivers-m) \
> -		     $(net-y) $(net-m) $(libs-y) $(libs-m)))
> +		     $(net-y) $(net-m) $(libs-y) $(libs-m))	\
> +		     $(samples-y) $(samples-m))
> +
>  
>  vmlinux-alldirs	:= $(sort $(vmlinux-dirs) $(patsubst %/,%,$(filter %/, \
> -		     $(init-n) $(init-) \
> +		     $(init-n) $(init-) $(samples-n) $(samples-) \
>  		     $(core-n) $(core-) $(drivers-n) $(drivers-) \
>  		     $(net-n)  $(net-)  $(libs-n)    $(libs-))))
>  
> @@ -578,6 +581,7 @@ net-y		:= $(patsubst %/, %/built-in.o, $
>  libs-y1		:= $(patsubst %/, %/lib.a, $(libs-y))
>  libs-y2		:= $(patsubst %/, %/built-in.o, $(libs-y))
>  libs-y		:= $(libs-y1) $(libs-y2)
> +samples-y	:= $(patsubst %/, %/built-in.o, $(samples-y))
>  
>  # Build vmlinux
>  # ---------------------------------------------------------------------------
> @@ -607,7 +611,7 @@ libs-y		:= $(libs-y1) $(libs-y2)
>  # System.map is generated to document addresses of all kernel symbols
>  
>  vmlinux-init := $(head-y) $(init-y)
> -vmlinux-main := $(core-y) $(libs-y) $(drivers-y) $(net-y)
> +vmlinux-main := $(core-y) $(libs-y) $(drivers-y) $(net-y) $(samples-y)
>  vmlinux-all  := $(vmlinux-init) $(vmlinux-main)
>  vmlinux-lds  := arch/$(ARCH)/kernel/vmlinux.lds
>  export KBUILD_VMLINUX_OBJS := $(vmlinux-all)
> --- /dev/null
> +++ linux-2.6.23-rc7/samples/Kbuild
> @@ -0,0 +1,2 @@
> +# Makefile for Linux samples code
> +
> --- /dev/null
> +++ linux-2.6.23-rc7/samples/Kconfig
> @@ -0,0 +1,11 @@
> +# samples/Kconfig
> +
> +menuconfig SAMPLES
> +	bool "Sample kernel code"
> +	help
> +	  You can build and test sample kernel code here.
> +
> +if SAMPLES
> +
> +
> +endif # SAMPLES
> --- linux-2.6.23-rc7.orig/arch/alpha/Kconfig
> +++ linux-2.6.23-rc7/arch/alpha/Kconfig
> @@ -669,5 +669,7 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
>  
> --- linux-2.6.23-rc7.orig/arch/arm/Kconfig
> +++ linux-2.6.23-rc7/arch/arm/Kconfig
> @@ -1067,4 +1067,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/avr32/Kconfig
> +++ linux-2.6.23-rc7/arch/avr32/Kconfig
> @@ -237,4 +237,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/blackfin/Kconfig
> +++ linux-2.6.23-rc7/arch/blackfin/Kconfig
> @@ -1012,4 +1012,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/cris/Kconfig
> +++ linux-2.6.23-rc7/arch/cris/Kconfig
> @@ -202,4 +202,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/frv/Kconfig
> +++ linux-2.6.23-rc7/arch/frv/Kconfig
> @@ -381,4 +381,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/h8300/Kconfig
> +++ linux-2.6.23-rc7/arch/h8300/Kconfig
> @@ -229,4 +229,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/i386/Kconfig
> +++ linux-2.6.23-rc7/arch/i386/Kconfig
> @@ -1260,6 +1260,8 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
>  
>  #
> --- linux-2.6.23-rc7.orig/arch/ia64/Kconfig
> +++ linux-2.6.23-rc7/arch/ia64/Kconfig
> @@ -594,3 +594,5 @@ source "arch/ia64/Kconfig.debug"
>  source "security/Kconfig"
>  
>  source "crypto/Kconfig"
> +
> +source "samples/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/m32r/Kconfig
> +++ linux-2.6.23-rc7/arch/m32r/Kconfig
> @@ -434,4 +434,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/m68k/Kconfig
> +++ linux-2.6.23-rc7/arch/m68k/Kconfig
> @@ -689,4 +689,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/m68knommu/Kconfig
> +++ linux-2.6.23-rc7/arch/m68knommu/Kconfig
> @@ -702,4 +702,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/mips/Kconfig
> +++ linux-2.6.23-rc7/arch/mips/Kconfig
> @@ -1924,4 +1924,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/parisc/Kconfig
> +++ linux-2.6.23-rc7/arch/parisc/Kconfig
> @@ -275,4 +275,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/powerpc/Kconfig
> +++ linux-2.6.23-rc7/arch/powerpc/Kconfig
> @@ -662,3 +662,5 @@ config KEYS_COMPAT
>  	default y
>  
>  source "crypto/Kconfig"
> +
> +source "samples/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/ppc/Kconfig
> +++ linux-2.6.23-rc7/arch/ppc/Kconfig
> @@ -1460,3 +1460,5 @@ source "arch/ppc/Kconfig.debug"
>  source "security/Kconfig"
>  
>  source "crypto/Kconfig"
> +
> +source "samples/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/s390/Kconfig
> +++ linux-2.6.23-rc7/arch/s390/Kconfig
> @@ -551,4 +551,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/sh/Kconfig
> +++ linux-2.6.23-rc7/arch/sh/Kconfig
> @@ -739,4 +739,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/sh64/Kconfig
> +++ linux-2.6.23-rc7/arch/sh64/Kconfig
> @@ -293,6 +293,8 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
>  
>  #
> --- linux-2.6.23-rc7.orig/arch/sparc/Kconfig
> +++ linux-2.6.23-rc7/arch/sparc/Kconfig
> @@ -333,4 +333,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/sparc64/Kconfig
> +++ linux-2.6.23-rc7/arch/sparc64/Kconfig
> @@ -482,4 +482,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/um/Kconfig
> +++ linux-2.6.23-rc7/arch/um/Kconfig
> @@ -320,6 +320,8 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
>  
>  source "drivers/scsi/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/v850/Kconfig
> +++ linux-2.6.23-rc7/arch/v850/Kconfig
> @@ -337,6 +337,8 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
>  
>  #############################################################################
> --- linux-2.6.23-rc7.orig/arch/x86_64/Kconfig
> +++ linux-2.6.23-rc7/arch/x86_64/Kconfig
> @@ -805,4 +805,6 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> +source "samples/Kconfig"
> +
>  source "lib/Kconfig"
> --- linux-2.6.23-rc7.orig/arch/xtensa/Kconfig
> +++ linux-2.6.23-rc7/arch/xtensa/Kconfig
> @@ -257,6 +257,7 @@ source "security/Kconfig"
>  
>  source "crypto/Kconfig"
>  
> -source "lib/Kconfig"
> +source "samples/Kconfig"
>  
> +source "lib/Kconfig"
>  

-- 
Mathieu Desnoyers
Computer Engineering Ph.D. Student, Ecole Polytechnique de Montreal
OpenPGP key fingerprint: 8CD5 52C3 8E3C 4140 715F  BA06 3F25 A8FE 3BAE 9A68
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/