linux/Documentation/dynamic-debug-howto.txt
<<
>>
Prefs
   1
   2Introduction
   3============
   4
   5This document describes how to use the dynamic debug (dyndbg) feature.
   6
   7Dynamic debug is designed to allow you to dynamically enable/disable
   8kernel code to obtain additional kernel information.  Currently, if
   9CONFIG_DYNAMIC_DEBUG is set, then all pr_debug()/dev_dbg() calls can
  10be dynamically enabled per-callsite.
  11
  12Dynamic debug has even more useful features:
  13
  14 * Simple query language allows turning on and o.2sdebug1howtoug-on/dellows by /a>ch14">any8" mbins tura>  0 or 1a> 2Dynamic debug has even more useful features:
<   6
1ynam.txt#L6" id="L6" class="line" name="L6">   6
1   6
1   1
   6
2a href="2ocumentation/dynamic-de2ug-ho21owtoug-- f8-onr query language allows turning on and o.2   1
   1
   isplay="L5"" m idte tist">  known Simpl.txt#L1" id="L1" class="line" name="L1">   1
<34.102debug2howtoug-on/dellows,">  help guicl="L7.txt#L1" id="L1" class="line" name="L1">   1
<   6
2   5This Behaviour.txt#L6" id="L6" class="line" name="L6">   6
2   6
2   6
3a href="3ocumentation/dynamic-de3ug-ho30owto.te t#haviour">  ">   9CONFIG_DYNa a

   6
3a href="3ocumentation/dynamic-de3ug-ho31owtoBotxt#l 
	 >>  ="L5"'SimplfD #39; 
	 >sysdel. Thus,""L7"must"first"mount.txt#L6" id="L6" class="line" name="L6">   6
3implfDE
	 >sysdel,>  =order ne"make" na">  earc describes how to use the dynamic debug (dyndbg) feature.
3>a12Dynamic debug has even more useful features:
3a href="3ocumentation/dynamic-de3ug-ho34owto<SimplfD   <"line" n   9Dynamic debug has even more useful features:
334.103debug3howtopr qneva from source 
	 >"'svcsock.c', tion 1603""L7"s4" iy#L52Dynamic debug has even more useful features:
3   6
3"svcsock.c tion 1603"+p #39;    <.txt#L6" id="L6" class="line" name="L6">   6
3   1
3   6
4a href="4ocumentation/dynamic-de4ug-ho40owtoIa""L7"make"a mistake"with""L5"sy clxe" na wrine"wi"L9fail" nu12Dynamic debug has even more useful features:
4a href="4ocumentation/dynamic-de4ug-ho4to.txt#L11" id="L11" class="line" name="L11">  11
4"svcsock.c wtf 1a+p #39;    <.txt#L6" id="L6" class="line" name="L6">   6
4   1
4   1
434.104debug45o.txt#L11" id="L11" class="line" name="L11">  11
4   6
4   6
4  11
4  ="L9"L5">impl.txt#L4" id="L4" class="line" name="L4">   4
  11
5-<SimplfD   <"line" n   9   1
5ynam:tionno [m#L2id]fun" id= flags f8.txt#L1" id="L1" class="line" name="L1">   1
5iregister RPC RDMA transport\012".txt#L1" id="L1" class="line" name="L1">   1
5   1
5   1
5   1
5   6
6a href="6ocumentation/dynamic-de6ug-ho60owto.txt#L6" id="L6" class="line" name="L6">   6
6a href="6ocumentation/dynamic-de6ug-ho61owtoYL7"BUG also ap iy#on/ndard Unix n" n"manipuls tura
	 ters ne""Lis.txt#L6" id="L6" class="line" name="L6">   6
6  13
6   1
6   1
6   6
6   1
6   1
6   6
7a href="7ocumentation/dynamic-de7ug-ho70owto.te "Lird column sh nameL5""code to " class="flags f8< each">impl.txt#L4" id="L4" class="line" name="L4">   4
7a href="7ocumentation/dynamic-de7ug-ho71owtoon/dellow " name=" (see t#ame=f8< ONfinitss=s">  eae"flags).  .te.txt#L4" id="L4" class="line" name="L4">   4
7   4
7impl on/dellow " name="s"with"any8non-dNfaultyflags2Dynamic debug has even more useful features:
7   4
7   1
7ynam:tionno [m#L2id]fun" id= flags f8.txt#L1" id="L1" class="line" name="L1">   1
7   1
7  11
7   6
8a href="8ocumentation/dynamic-de8ug-ho80owtoComm4   6
8a href="8ocumentation/dynamic-de8ug-ho81owto.txt#L3" id===============.txt#L6" id="L6" class="line" name="L6">   6
8   1
8  word="lipar/ded.txt#L1" id="L1" class="line" name="L1">   1
8r tabs.  So"eaese a

<="L9e"Lipe=" c2Dynamic debug has even more useful features:
8  11
8"svcsock.c tion 1603"+p #39;    <.txt#L6" id="L6" class="line" name="L6">   6
8   1
8" "svcsock.c     tion  1603"+p   #39;    <.txt#L6" id="L6" class="line" name="L6">   6
8   1
9a href="9ocumentation/dynamic-de9ug-ho90owtonullarbor:~ # echo"-n"'
	 >"svcsock.c tion 1603"+p #39;    <.txt#L6" id="L6" class="line" name="L6">   6
9a href="9ocumentation/dynamic-de9ug-ho91owtoug------------------------------<SimplfD   <"line" n   9   1
9   1
9
 ssss=s"a

r  #39;\n #39;es how to use the dynamic debug (dyndbg) feature.
9  11
9  11
9   1
9  11
9ch"eaem to52Dynamic debug has even more useful features:
10a href="Doocumentation/dynamic-debuug-hbuuowto.txt#L6" id="L6" class="line" name="L6">   6
10a href="D0ocumentation/dynamic-deb01g-hbu1owtoug~# ca>-"L14"-ba>ch-
	 >"&  <-<SimplfD   <"line" n   9   1
10a href="D0ocumentation/dynamic-deb02g-hbu2owto.txt#L1" id="L1" class="line" name="L1">   1
10a href="D0ocumentation/dynamic-deb03g-hbu3owtoAt eae"sy cl" i="L"level, a"" mm4  /a>ch.txt#L1" id="L1" class="line" name="L1">   1
10a href="D0ocumentation/dynamic-deb04g-hbuhowtospecifi="tss=s, f8e" nbd ty a flags chlass specifi="tss=L10">  10be dynamically enabled per-callsite.
<034.10s05g-hbu5o.txt#L11" id="L11" class="line" name="L11">  11
10ch-spec* flags-spect#L11" id="L11" class="line" name="L11">  11
10  11
10ch-spec's"a

sets>  eae"known ">   9t#L11" id="L11" class="line" name="L11">  11
10  eaem aa a "L14"10">  10be dynamically enabled per-callsite.
-UG empty tist"> 10">  10be dynamically enabled per-callsite.
  10be dynamically enabled per-callsite.
   1
1   1
1   1
1<34.10ssdebu11howtoagainst.  Poenib >"keywords"a

2Dynamic debug has even more useful features:
1<   6
11ch-speca::= '
un" #39; onr qu |.txt#L6" id="L6" class="line" name="L6">   6
11 #39; onr qu |.txt#L6" id="L6" class="line" name="L6">   6
11   6
1   6
1   6
1   1
1   6
1   6
1<34.1012debu12howtoug-------------on/dno #39;- #39; |.txt#L6" id="L6" class="line" name="L6">   6
1<   6
1<   6
13a href="13ocumentation/dynamic-de13ug-h130owtoon/dno ::= unass="l-i c.txt#L1" id="L1" class="line" name="L1">   1
13a href="13ocumentation/dynamic-de13ug-h13to.txt#L11" id="L11" class="line" name="L11">  11
<3  each"keyword"a

2Dynamic debug has even more useful features:
13a href="Doocumentation/dynamic-debuug-h13to.txt#L13" id="L13" class="line" name="L13">  13
<3a href="13ocumentation/dynamic-de13ug-h134owto
un"t#L13" id="L13" class="line" name="L13">  13
<334.1013debu13howtoug--.te giss="onr qu is"" m a

d against#eae"fun" id= ynam.txt#L6" id="L6" class="line" name="L6">   6
13  each"" name="L  Exam id2Dynamic debug has even more useful features:
13  11
13   1
13   6
14a href="14ocumentation/dynamic-de14ug-h140owto
	 >.txt#L6" id="L6" class="line" name="L6">   6
14a href="14ocumentation/dynamic-de14ug-h141owtoug--.te giss="onr qu is"" m a

d against#eieaer#eae"fu"L9"athamic,meL5.txt#L1" id="L1" class="line" name="L1">   1
14ynams>  eae"source 
	 >"> 10">  10be dynamically enabled per-callsite.
<4   4
1434.1014debu14howtoug--
	 >"svcsock.c.txt#L4" id="L4" class="line" name="L4">   4
14"e="L8"/freezer.c.txt#L4" id="L4" class="line" name="L4">   4
14"/usr/src/packages/BUILD/sgi-enhancednfs-1.4CONfault/net/sunrpc/svcsock.c.txt#L4" id="L4" class="line" name="L4">   4
14  11
14  11
1   6
15a href="15ocumentation/dynamic-de15ug-h151owtoug-->  each"" name="L  Tae"m#L2id=ynam is"eae"snr qu as.txt#L6" id="L6" class="line" name="L6">   6
15   6
15Dynamic debug has even more useful features:
<5   4
15   4
15   1
15  11
15.txt#L1" id="L1" class="line" name="L1">   1
15s="for#  ="L5"line" n9>impl f8.txt#L1" id="L1" class="line" name="L1">   1
16a href="16ocumentation/dynamic-de16ug-h160owtoug--onr qu.  Note "La>-eae"snr qu doe="not nesline"ma>ch"eae.txt#L1" id="L1" class="line" name="L1">   1
16a href="16ocumentation/dynamic-de16ug-h161owtoug--" cire f8,moniy#oome9"art.  Whe="spacs14eaer.txt#L1" id="L1" class="line" name="L1">   1
16   1
16Dynamic debug has even more useful features:
<6  11
16-ovcrdma:---------//"manys>  eae"NFS/RDMA server ">   9   6
16-rup"akup"--------//"oome9">   9ch"a-f8-with"whe="spacss how to use the dynamic debug (dyndbg) feature.
17a href="17ocumentation/dynamic-de17ug-h171owtoug--f8- quot;nfsd: SETATTR quot; -//"a neater way="e"ma>ch"a-f8-with"whe="spacss how to use the dynamic debug (dyndbg) feature.
17- #39;nfsd: SETATTR #39;  //"ye>-UG>eaer way="e"ma>ch"a-f8-with"whe="spacss how to use the dynamic debug (dyndbg) feature.
17  13
<7  13
<7  tion numbers is"" m a

dt#L13" id="L13" class="line" name="L13">  13
<7   9"" name="L  A#s quidt#L13" id="L13" class="line" name="L13">  13
<7ches eae"" name=" tion number exactlyL  At#L13" id="L13" class="line" name="L13">  13
<7  tion numbers ma>ches any8" name=" between eae"firstt#L13" id="L13" class="line" name="L13">  13
<7   6
18a href="18ocumentation/dynamic-de18ug-h180owtoug--eae"first tion in eae"fiidobUG empty tion number means"eae.txt#L1" id="L1" class="line" name="L1">   1
18a href="18ocumentation/dynamic-de18ug-h181owtoug--umet number in eae"fiide  Exam id12Dynamic debug has even more useful features:
<8   1
18   1
18   1
18   1
18  eae"fiid.txt#L1" id="L1" class="line" name="L1">   1
18  11
18  11
18  13
<9a href="19ocumentation/dynamic-de19ug-h190owto>  eae""hlracters2Dynamic debug has even more useful features:
<9a href="19ocumentation/dynamic-de19ug-h19to.txt#L11" id="L11" class="line" name="L11">  11
<9  11
<9  11
<9  11
<9  11
19Dynamic debug has even more useful features:
19  11
19   9"" name="Lt#L11" id="L11" class="line" name="L11">  11
19   6
20a href="2oocumentation/dynamic-de2uug-h200owtouglug--In=Du"e#tion number in eae"pr qned messass.txt#L6" id="L6" class="line" name="L6">   6
20a href="20ocumentation/dynamic-de201g-h2u1owtougmug--In=Du"e#m#L2id=ynam in eae"pr qned messass.txt#L6" id="L6" class="line" name="L6">   6
20  13
20a href="20ocumentation/dynamic-de203g-h203owtoug_ug--No flags a

-set. (Or'S-with">eaers"oo ax+*").txt#L1" id="L1" class="line" name="L1">   1
   4
2034.10205g-h2u5o.txFor  isplay,#eae"flags=a

-preceded ty  #39;= #39;.txt#L4" id="L4" class="line" name="L4">   4
20-eae"flags=a

-"code to " qual="e)es how to use the dynamic debug (dyndbg) feature.
20  11
20ches a flags specifi="tss=es how to use the dynamic debug (dyndbg) feature.
20r  quot;-flmpt".s how to use the dynamic debug (dyndbg) feature.
2aa href="2Documentation/dynamic-de2bug-h21uowto.txt#L6" id="L6" class="line" name="L6">   6
2aa href="2oocumentation/dynamic-de2u1g-h2wto.txt#L11" id="L11" class="line" name="L11">  11
2aa href="2Documentation/dynamic-de2bug-h2wto.txtimpl messass="dur qu BootEProcesst#L11" id="L11" class="line" name="L11">  11
2aa href="2Documentation/dynamic-de2bug-h21howto.txt#L3" id=======================.txt#L6" id="L6" class="line" name="L6">   6
2   4
2<34.102sdebu21howtoTo l" iv/de9>impl messass="for#co

   4
2<   4
2<   4
2<  11
2a   6
2  10be dynamically enabled per-callsite.
22a href="22ocumentation/dynamic-de22ug-h22to.txt#L11" id="L11" class="line" name="L11">  11
22   1
2  eae"div>
init" nae  Thus""L7"BUG " lass Simpl.txt#L1" id="L1" class="line" name="L1">   1
<
init" na"via eais"boot.txt#L1" id="L1" class="line" name="L1">   1
<<34.1022debu22howto"aramdterL10">  10be dynamically enabled per-callsite.
22   6
22sys
init" na"4   6
22"ec.c +p quot;.txt#L6" id="L6" class="line" name="L6">   6
22  earo "Embedded Cotxt#ller#eransPrefs
="dur qu ACPI setupbtain additional kernel information.  Currently, if
23a href="23ocumentation/dynamic-de23ug-h230owto"L7r=mach14e (typd="L10"a laptop)2" cl4< Embedded Cotxt#llerL10">  10be dynamically enabled per-callsite.
23a href="23ocumentation/dynamic-de23ug-h23to.txPCI (or >eaer devices) initsaliz"tss=aalso is aahotEB4  10be dynamically enabled per-callsite.
23  10be dynamically enabled per-callsite.
23a href="2oocumentation/dynamic-de2uug-h23to.txt#L13" id="L13" class="line" name="L13">  13
23a href="23ocumentation/dynamic-de23ug-h234owtoIf=f8o#m#L2id=s="notabuilt-in, f8o.dcumen"wi"L9oti"L9b
-processslia>.txt#L1" id="L1" class="line" name="L1">   1
2334.1023debu23howtoboot timh,"without#effect,"but wi"L9b
-reprocesssliwhen#m#L2id=s=.txt#L1" id="L1" class="line" name="L1">   1
23.txt#L1" id="L1" class="line" name="L1">   1
23  10be dynamically enabled per-callsite.
23  11
23   6
24a href="24ocumentation/dynamic-de24ug-h240owtotimpl Messass="at M#L2id=Initsaliz"tss=aTiam.txt#L6" id="L6" class="line" name="L6">   6
24a href="24ocumentation/dynamic-de24ug-h241owto.txt#L3" id=================================.txt#L6" id="L6" class="line" name="L6">   6
24   1
<4   1
<4a href="2oocumentation/dynamic-de2uug-h24howtof8o."arams,"snr p=""f8o. quot;, 4along"with.txt#L1" id="L1" class="line" name="L1">   1
<434.1024debu24howto"arams"giss="in m#Lprobe9arg=">r /etc/m#Lprob.d/*." tfE
	 >s,.txt#L1" id="L1" class="line" name="L1">   1
<4 rder2Dynamic debug has even more useful features:
24  11
24  11
24   1
2   1
2  11
25   6
25   6
25   4
25   4
25   1
25  11
25  10be dynamically enabled per-callsite.
25  10be dynamically enabled per-callsite.
26a href="26ocumentation/dynamic-de26ug-h260owto(sennib >,#s qcn 1=is"or#boot specifi=),"4   6
26a href="26ocumentation/dynamic-de26ug-h261owtom#Lprobe9arg="to overricl=bothL10">  10be dynamically enabled per-callsite.
26   1
<6  10be dynamically enabled per-callsite.
26  10be dynamically enabled per-callsite.
26niy#1 /a>ch-spec o  each"typd=s="ae" nbdL10">  10be dynamically enabled per-callsite.
26   6
26  11
26  10be dynamically enabled per-callsite.
27a href="27ocumentation/dynamic-de27ug-h270owto-lass4"am#L2id=gets=st"tacitl",-wheeaer#eaeyb na"">   9or#not.txt#L1" id="L1" class="line" name="L1">   1
<7a href="27ocumentation/dynamic-de27ug-h271owto-=st"doe=ntaap ear"im /   1
<7  10be dynamically enabled per-callsite.
27  13
27  13
27  13
27impl messass="a

 no longer"nesled2Dynamic debug has even more useful features:
27  11
27   1
27   6
28a href="28ocumentation/dynamic-de28ug-h280owtoExam id1.txt#L6" id="L6" class="line" name="L6">   6
28a href="28ocumentation/dynamic-de28ug-h281owto.txt#L3".txt#L6" id="L6" class="line" name="L6">   6
28   1
28"svcsock.c.txt#L4" id="L4" class="line" name="L4">   4
28"svcsock.c tion 1603"+p #39;    <.txt#L6" id="L6" class="line" name="L6">   6
28   1
28   6
28   4
28"svcsock.c +p #39;    <.txt#L6" id="L6" class="line" name="L6">   6
28   1
29a href="29ocumentation/dynamic-de29ug-h29uowto.txt#L6" id="L6" class="line" name="L6">   6
29a href="29ocumentation/dynamic-de29ug-h29to.tx//"e lass  na"eae"messass="imeeae"NFS server m#L2idt#L11" id="L11" class="line" name="L11">  11
29   6
29   1
29   4
29t#L11" id="L11" class="line" name="L11">  11
29   6
29   1
29  11
29t#L11" id="L11" class="line" name="L11">  11
30a href="3oocumentation/dynamic-de3uug-h300owtonullarbor:~ # echo"-n"'
un" svc_process -p #39;    <.txt#L6" id="L6" class="line" name="L6">   6
30a href="30ocumentation/dynamic-de301g-h301owtoug------------------------------<SimplfD   <"line" n   9   1
30   1
30a href="30ocumentation/dynamic-de303g-h303owto//"e lass messass="for#NFS " nam READ, READLINK, READDIR 4  10be dynamically enabled per-callsite.
3aa href="30ocumentation/dynamic-de304g-h304owtonullarbor:~ # echo"-n"'
8- quot;nfsd: READ quot; +p #39;    <.txt#L6" id="L6" class="line" name="L6">   6
3034.10305g-h30howtoug------------------------------<SimplfD   <"line" n   9   1
30   6
30   6
308a href=30"Documentation/dynamic-308g-h308owtonullarbor:~ # echo"-n"'+p #39;    <-<SimplfD   <"line" n   9   1
309a href=30"Documentation/dynamic-309g-h309owto.txt#L6" id="L6" class="line" name="L6">   6
3aa href="3Documentation/dynamic-de3bug-h31uowto//"=dd m#L2id,"fun" id= to a"L9eclass="messass=.txt#L6" id="L6" class="line" name="L6">   6
3aa href="3oocumentation/dynamic-de3u1g-h3wto.txnullarbor:~ # echo"-n"'+mf #39;    <-<SimplfD   <"line" n   9   1
3aa href="3Documentation/dynamic-de3bug-h312owto.txt#L1" id="L1" class="line" name="L1">   1
3aa href="3Documentation/dynamic-de3bug-h313owto//"boot-arg="exam id,"with"newon/ds 4  10be dynamically enabled per-callsite.
3Bomm4  10be dynamically enabled per-callsite.
3<34.103sdebu31howtoug//"oee wLa>s go14"> ="in dcumen=pe="hiprocess qu10">  10be dynamically enabled per-callsite.
3<  10be dynamically enabled per-callsite.
3<   9  10be dynamically enabled per-callsite.
3<8a href=31"Documentation/dynamic-31debu318owtougdcumen="m#L2id="arams +p #cmt ; m#L2id=sys +p quot;.txt#L6" id="L6" class="line" name="L6">   6
3a   9   6
3   6
32a href="32ocumentation/dynamic-de32ug-h32to.tx


The originaL9LXR softwa LXR Bommunityo.tx, eais"experi6" cll versss=lxr@on/ux.noo.tx.
lxr.on/ux.no kindly hosted ty txt#L6" ihttp://www.redpill-on/pro.no">Redpill Ln/pro ASo.tx, provider o Ln/ux""otsultiqu aper"tss=s services#s qcn 1995.