Source

[Some of this is taken from Frohwalt Egerer's original linux-kernel FAQ]WhatfollowsisasuggestedprocedureforreportingLinuxbugs.Youaren'tobligedtousethebugreportingformat,itisprovidedasaguidetothekindofinformationthatcanbeusefultodevelopers-nomore.Ifthefailureincludesan"OOPS:"typemessageinyourlogoronscreenpleaseread"Documentation/oops-tracing.txt"beforepostingyourbugreport.Thisexplainswhatyoushoulddowiththe"Oops"informationtomakeitusefultotherecipient.Sendtheoutputtothemaintainerofthekernelareathatseemstobeinvolvedwiththeproblem,andcctherelevantmailinglist.Don'tworrytoomuchaboutgettingthewrongperson.Ifyouareunsuresendittothepersonresponsibleforthecoderelevanttowhatyouweredoing.Ifitoccursrepeatablytryanddescribehowtorecreateit.Thatisworthevenmorethantheoopsitself.ThelistofmaintainersandmailinglistsisintheMAINTAINERSfileinthisdirectory.Ifyouknowthefilenamethatcausestheproblemyoucanusethefollowingcommandinthisdirectorytofindsomeofthemaintainersofthatfile:perlscripts/get_maintainer.pl-f<filename>Ifitisasecuritybug,pleasecopytheSecurityContactlistedintheMAINTAINERSfile.Theycanhelpcoordinatebugfixanddisclosure.SeeDocumentation/SecurityBugsformoreinformation.Ifyouaretotallystumpedastowhomtosendthereport,sendittolinux-kernel@vger.kernel.org.(Formoreinformationonthelinux-kernelmailinglistseehttp://www.tux.org/lkml/).ThisisasuggestedformatforabugreportsenttotheLinuxkernelmailinglist.Havingastandardizedbugreportformmakesiteasierforyounottooverlookthings,andeasierforthedeveloperstofindthepiecesofinformationthey'rereallyinterestedin.Don'tfeelyouhavetofollowit.Firstrunthever_linuxscriptincludedasscripts/ver_linux,whichreportstheversionofsomeimportantsubsystems.Runthisscriptwiththecommand"shscripts/ver_linux".Usethatinformationtofillinallfieldsofthebugreportform,andpostittothemailinglistwithasubjectof"PROBLEM:<onelinesummaryfrom[1.]>"foreasyidentificationbythedevelopers.[1.]Onelinesummaryoftheproblem:[2.]Fulldescriptionoftheproblem/report:[3.]Keywords(i.e.,modules,networking,kernel):[4.]Kernelinformation[4.1.]Kernelversion(from/proc/version):[4.2.]Kernel.configfile:[5.]Mostrecentkernelversionwhichdidnothavethebug:[6.]OutputofOops..message(ifapplicable)withsymbolicinformationresolved(seeDocumentation/oops-tracing.txt)[7.]Asmallshellscriptorexampleprogramwhichtriggerstheproblem(ifpossible)[8.]Environment[8.1.]Software(addtheoutputofthever_linuxscripthere)[8.2.]Processorinformation(from/proc/cpuinfo):[8.3.]Moduleinformation(from/proc/modules):[8.4.]Loadeddriverandhardwareinformation(/proc/ioports,/proc/iomem)[8.5.]PCIinformation('lspci-vvv'asroot)[8.6.]SCSIinformation(from/proc/scsi/scsi)[8.7.]Otherinformationthatmightberelevanttotheproblem(pleaselookin/procandincludeallinformationthatyouthinktoberelevant):[X.]Othernotes,patches,fixes,workarounds:Thankyou