PSARC 2008/206 A new (k)mdb command ::stackinfo, kernel thread stack usage

[Philippe Jung]

Gary Winiger wrote:
>>>> 	A new tunable in /etc/system, like slab allocator debug kmem_flags.
>>>>
>>>> 	set kmem_stackinfo = 0x1
>>>>     
>>>>         
>>> 	What's the Interface Stability of this?  Must it be hex?  The
>>> 	description says non-zero? 
>>>       
>> 4.5. Interfaces:
>>
>>     A new tunable in /etc/system, kmem_stackinfo,
>>     an unsigned integer, default value is 0.
>>     (0: feature off, !=0: feature on)
>>     
>>>  Where/how is its presence documented?
>>>   
>>> From Alan.Hargreaves at sun.com: "If this interface is to be supported,
>>> it is important that it be well  documented. I *hope* there are plans
>>> to get this into the Tunable Parameters guide."
>>>   
>>>       
>> 4.6. Doc Impact
>>
>>         Solaris Modular Debugger Guide
>>         Solaris Tunable Parameters Reference Manual
>>     
>
> 	So if I read this correctly, the /etc/system variable will
> 	only be documented in the docs.sun.com docs and not the man
> 	pages.  But there's a Committed ::stackinfo (k)mdb command
> 	that will be documented in the man page(s) and ::help, but
> 	it's activation will not be?
>
> 	I'm not concerned with the content of the case, but how
> 	admins/users/developers/debuggers will put the pieces
> 	together to activate and use it.
>
> Gary..
>   
Understood.
The ::help stackinfo display will be modified to explain
also the kmem_stackinfo tunable, and describe more the feature,
like in section "4.1. Details".

-- 
Philippe JUNG                          Sun microsystems GEG http://gec.sun.com/
180, Avenue de l'Europe                mailto:philippe.jung at sun.com
ZIRST de Montbonnot                    tel: +33 4 76 18 80 58
38334 Saint Ismier Cedex