[PATCH] Document kernel taint flags properly

[PATCH] Document kernel taint flags properly

[Greg KH]

From: Greg Kroah-Hartman <gregkh@suse.de>

This fills in the documentation for all of the current kernel taint
flags, and fixes the number for TAINT_CRAP, which was incorrectly
described.

Cc: Michael Kerrisk <mtk.manpages@gmail.com>
Cc: Randy Dunlap <rdunlap@xenotime.net>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>

---
 Documentation/sysctl/kernel.txt |   24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

--- a/Documentation/sysctl/kernel.txt
+++ b/Documentation/sysctl/kernel.txt
@@ -363,11 +363,21 @@ tainted: 
 Non-zero if the kernel has been tainted.  Numeric values, which
 can be ORed together:
 
-  1 - A module with a non-GPL license has been loaded, this
-      includes modules with no license.
-      Set by modutils >= 2.4.9 and module-init-tools.
-  2 - A module was force loaded by insmod -f.
-      Set by modutils >= 2.4.9 and module-init-tools.
-  4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
- 64 - A module from drivers/staging was loaded.
+   1 - A module with a non-GPL license has been loaded, this
+       includes modules with no license.
+       Set by modutils >= 2.4.9 and module-init-tools.
+   2 - A module was force loaded by insmod -f.
+       Set by modutils >= 2.4.9 and module-init-tools.
+   4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
+   8 - A module was forcefully unloaded from the system by rmmod -f.
+  16 - A hardware machine check error occured on the system.
+  32 - A bad page was discovered on the system.
+  64 - The user has asked that the system be marked "tainted".  This
+       could be because they are running software that directly modifies
+       the hardware, or for other reasons.
+ 128 - The system has died.
+ 256 - The ACPI DSDT has been overridden with one supplied by the user
+        instead of using the one provided by the hardware.
+ 512 - A kernel warning has occurred.
+1024 - A module from drivers/staging was loaded.
 

Re: [PATCH] Document kernel taint flags properly

[Michael Kerrisk]

Greg,

Small corrections below.

On Fri, Oct 17, 2008 at 5:55 PM, Greg KH <greg@kroah.com> wrote:
> From: Greg Kroah-Hartman <gregkh@suse.de>
>
> This fills in the documentation for all of the current kernel taint
> flags, and fixes the number for TAINT_CRAP, which was incorrectly
> described.
>
> Cc: Michael Kerrisk <mtk.manpages@gmail.com>
> Cc: Randy Dunlap <rdunlap@xenotime.net>
> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
>
> ---
>  Documentation/sysctl/kernel.txt |   24 +++++++++++++++++-------
>  1 file changed, 17 insertions(+), 7 deletions(-)
>
> --- a/Documentation/sysctl/kernel.txt
> +++ b/Documentation/sysctl/kernel.txt
> @@ -363,11 +363,21 @@ tainted:
>  Non-zero if the kernel has been tainted.  Numeric values, which
>  can be ORed together:
>
> -  1 - A module with a non-GPL license has been loaded, this
> -      includes modules with no license.
> -      Set by modutils >= 2.4.9 and module-init-tools.
> -  2 - A module was force loaded by insmod -f.
> -      Set by modutils >= 2.4.9 and module-init-tools.
> -  4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
> - 64 - A module from drivers/staging was loaded.
> +   1 - A module with a non-GPL license has been loaded, this
> +       includes modules with no license.
> +       Set by modutils >= 2.4.9 and module-init-tools.
> +   2 - A module was force loaded by insmod -f.
> +       Set by modutils >= 2.4.9 and module-init-tools.
> +   4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
> +   8 - A module was forcefully unloaded from the system by rmmod -f.

s/forcefully/forcibly/

> +  16 - A hardware machine check error occured on the system.

occurred

> +  32 - A bad page was discovered on the system.
> +  64 - The user has asked that the system be marked "tainted".  This
> +       could be because they are running software that directly modifies
> +       the hardware, or for other reasons.
> + 128 - The system has died.
> + 256 - The ACPI DSDT has been overridden with one supplied by the user
> +        instead of using the one provided by the hardware.
> + 512 - A kernel warning has occurred.
> +1024 - A module from drivers/staging was loaded.

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html

Re: [PATCH] Document kernel taint flags properly

[Greg KH]

On Sat, Oct 18, 2008 at 03:51:11AM -0500, Michael Kerrisk wrote:
> Greg,
> 
> Small corrections below.
> 
> On Fri, Oct 17, 2008 at 5:55 PM, Greg KH <greg@kroah.com> wrote:
> > From: Greg Kroah-Hartman <gregkh@suse.de>
> >
> > This fills in the documentation for all of the current kernel taint
> > flags, and fixes the number for TAINT_CRAP, which was incorrectly
> > described.
> >
> > Cc: Michael Kerrisk <mtk.manpages@gmail.com>
> > Cc: Randy Dunlap <rdunlap@xenotime.net>
> > Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
> >
> > ---
> >  Documentation/sysctl/kernel.txt |   24 +++++++++++++++++-------
> >  1 file changed, 17 insertions(+), 7 deletions(-)
> >
> > --- a/Documentation/sysctl/kernel.txt
> > +++ b/Documentation/sysctl/kernel.txt
> > @@ -363,11 +363,21 @@ tainted:
> >  Non-zero if the kernel has been tainted.  Numeric values, which
> >  can be ORed together:
> >
> > -  1 - A module with a non-GPL license has been loaded, this
> > -      includes modules with no license.
> > -      Set by modutils >= 2.4.9 and module-init-tools.
> > -  2 - A module was force loaded by insmod -f.
> > -      Set by modutils >= 2.4.9 and module-init-tools.
> > -  4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
> > - 64 - A module from drivers/staging was loaded.
> > +   1 - A module with a non-GPL license has been loaded, this
> > +       includes modules with no license.
> > +       Set by modutils >= 2.4.9 and module-init-tools.
> > +   2 - A module was force loaded by insmod -f.
> > +       Set by modutils >= 2.4.9 and module-init-tools.
> > +   4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
> > +   8 - A module was forcefully unloaded from the system by rmmod -f.
> 
> s/forcefully/forcibly/
> 
> > +  16 - A hardware machine check error occured on the system.
> 
> occurred

Thanks, I've updated this in my version.

Randy, I can send this through my tree, is that ok?  Or do you want it
to go through yours?

thanks,

greg k-h

Re: [PATCH] Document kernel taint flags properly

[Randy Dunlap]

Greg KH wrote:
> On Sat, Oct 18, 2008 at 03:51:11AM -0500, Michael Kerrisk wrote:
>   
>> Greg,
>>
>> Small corrections below.
>>
>> On Fri, Oct 17, 2008 at 5:55 PM, Greg KH <greg@kroah.com> wrote:
>>     
>>> From: Greg Kroah-Hartman <gregkh@suse.de>
>>>
>>> This fills in the documentation for all of the current kernel taint
>>> flags, and fixes the number for TAINT_CRAP, which was incorrectly
>>> described.
>>>
>>> Cc: Michael Kerrisk <mtk.manpages@gmail.com>
>>> Cc: Randy Dunlap <rdunlap@xenotime.net>
>>> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
>>>
>>> ---
>>>  Documentation/sysctl/kernel.txt |   24 +++++++++++++++++-------
>>>  1 file changed, 17 insertions(+), 7 deletions(-)
>>>
>>> --- a/Documentation/sysctl/kernel.txt
>>> +++ b/Documentation/sysctl/kernel.txt
>>> @@ -363,11 +363,21 @@ tainted:
>>>  Non-zero if the kernel has been tainted.  Numeric values, which
>>>  can be ORed together:
>>>
>>> -  1 - A module with a non-GPL license has been loaded, this
>>> -      includes modules with no license.
>>> -      Set by modutils >= 2.4.9 and module-init-tools.
>>> -  2 - A module was force loaded by insmod -f.
>>> -      Set by modutils >= 2.4.9 and module-init-tools.
>>> -  4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
>>> - 64 - A module from drivers/staging was loaded.
>>> +   1 - A module with a non-GPL license has been loaded, this
>>> +       includes modules with no license.
>>> +       Set by modutils >= 2.4.9 and module-init-tools.
>>> +   2 - A module was force loaded by insmod -f.
>>> +       Set by modutils >= 2.4.9 and module-init-tools.
>>> +   4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
>>> +   8 - A module was forcefully unloaded from the system by rmmod -f.
>>>       
>> s/forcefully/forcibly/
>>
>>     
>>> +  16 - A hardware machine check error occured on the system.
>>>       
>> occurred
>>     
>
> Thanks, I've updated this in my version.
>
> Randy, I can send this through my tree, is that ok?  Or do you want it
> to go through yours?
>   
You please go ahead with it.

Thanks,
~Randy

Re: [PATCH] Document kernel taint flags properly

[Greg KH]

On Mon, Oct 20, 2008 at 02:37:52PM -0700, Randy Dunlap wrote:
> Greg KH wrote:
> > On Sat, Oct 18, 2008 at 03:51:11AM -0500, Michael Kerrisk wrote:
> >   
> >> Greg,
> >>
> >> Small corrections below.
> >>
> >> On Fri, Oct 17, 2008 at 5:55 PM, Greg KH <greg@kroah.com> wrote:
> >>     
> >>> From: Greg Kroah-Hartman <gregkh@suse.de>
> >>>
> >>> This fills in the documentation for all of the current kernel taint
> >>> flags, and fixes the number for TAINT_CRAP, which was incorrectly
> >>> described.
> >>>
> >>> Cc: Michael Kerrisk <mtk.manpages@gmail.com>
> >>> Cc: Randy Dunlap <rdunlap@xenotime.net>
> >>> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
> >>>
> >>> ---
> >>>  Documentation/sysctl/kernel.txt |   24 +++++++++++++++++-------
> >>>  1 file changed, 17 insertions(+), 7 deletions(-)
> >>>
> >>> --- a/Documentation/sysctl/kernel.txt
> >>> +++ b/Documentation/sysctl/kernel.txt
> >>> @@ -363,11 +363,21 @@ tainted:
> >>>  Non-zero if the kernel has been tainted.  Numeric values, which
> >>>  can be ORed together:
> >>>
> >>> -  1 - A module with a non-GPL license has been loaded, this
> >>> -      includes modules with no license.
> >>> -      Set by modutils >= 2.4.9 and module-init-tools.
> >>> -  2 - A module was force loaded by insmod -f.
> >>> -      Set by modutils >= 2.4.9 and module-init-tools.
> >>> -  4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
> >>> - 64 - A module from drivers/staging was loaded.
> >>> +   1 - A module with a non-GPL license has been loaded, this
> >>> +       includes modules with no license.
> >>> +       Set by modutils >= 2.4.9 and module-init-tools.
> >>> +   2 - A module was force loaded by insmod -f.
> >>> +       Set by modutils >= 2.4.9 and module-init-tools.
> >>> +   4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
> >>> +   8 - A module was forcefully unloaded from the system by rmmod -f.
> >>>       
> >> s/forcefully/forcibly/
> >>
> >>     
> >>> +  16 - A hardware machine check error occured on the system.
> >>>       
> >> occurred
> >>     
> >
> > Thanks, I've updated this in my version.
> >
> > Randy, I can send this through my tree, is that ok?  Or do you want it
> > to go through yours?
> >   
> You please go ahead with it.

Will do.

thanks,

greg k-h