docs/htmldocs/bugreport.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Reporting Bugs</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
   9 "><LINK
  10 REL="HOME"
  11 TITLE="SAMBA Project Documentation"
  12 HREF="samba-howto-collection.html"><LINK
  13 REL="UP"
  14 TITLE="Appendixes"
  15 HREF="appendixes.html"><LINK
  16 REL="PREVIOUS"
  17 TITLE="Samba and other CIFS clients"
  18 HREF="other-clients.html"><LINK
  19 REL="NEXT"
  20 TITLE="Diagnosing your samba server"
  21 HREF="diagnosis.html"></HEAD
  22 ><BODY
  23 CLASS="CHAPTER"
  24 BGCOLOR="#FFFFFF"
  25 TEXT="#000000"
  26 LINK="#0000FF"
  27 VLINK="#840084"
  28 ALINK="#0000FF"
  29 ><DIV
  30 CLASS="NAVHEADER"
  31 ><TABLE
  32 SUMMARY="Header navigation table"
  33 WIDTH="100%"
  34 BORDER="0"
  35 CELLPADDING="0"
  36 CELLSPACING="0"
  37 ><TR
  38 ><TH
  39 COLSPAN="3"
  40 ALIGN="center"
  41 >SAMBA Project Documentation</TH
  42 ></TR
  43 ><TR
  44 ><TD
  45 WIDTH="10%"
  46 ALIGN="left"
  47 VALIGN="bottom"
  48 ><A
  49 HREF="other-clients.html"
  50 ACCESSKEY="P"
  51 >Prev</A
  52 ></TD
  53 ><TD
  54 WIDTH="80%"
  55 ALIGN="center"
  56 VALIGN="bottom"
  57 ></TD
  58 ><TD
  59 WIDTH="10%"
  60 ALIGN="right"
  61 VALIGN="bottom"
  62 ><A
  63 HREF="diagnosis.html"
  64 ACCESSKEY="N"
  65 >Next</A
  66 ></TD
  67 ></TR
  68 ></TABLE
  69 ><HR
  70 ALIGN="LEFT"
  71 WIDTH="100%"></DIV
  72 ><DIV
  73 CLASS="CHAPTER"
  74 ><H1
  75 ><A
  76 NAME="BUGREPORT">Chapter 25. Reporting Bugs</H1
  77 ><DIV
  78 CLASS="SECT1"
  79 ><H1
  80 CLASS="SECT1"
  81 ><A
  82 NAME="AEN3309">25.1. Introduction</H1
  83 ><P
  84 >The email address for bug reports for stable releases is <A
  85 HREF="samba@samba.org"
  86 TARGET="_top"
  87 >samba@samba.org</A
  88 >.
  89 Bug reports for alpha releases should go to <A
  90 HREF="mailto:samba-technical@samba.org"
  91 TARGET="_top"
  92 >samba-technical@samba.org</A
  93 >.</P
  94 ><P
  95 >Please take the time to read this file before you submit a bug
  96 report. Also, please see if it has changed between releases, as we
  97 may be changing the bug reporting mechanism at some time.</P
  98 ><P
  99 >Please also do as much as you can yourself to help track down the
 100 bug. Samba is maintained by a dedicated group of people who volunteer
 101 their time, skills and efforts. We receive far more mail about it than
 102 we can possibly answer, so you have a much higher chance of an answer
 103 and a fix if you send us a "developer friendly" bug report that lets
 104 us fix it fast. </P
 105 ><P
 106 >Do not assume that if you post the bug to the comp.protocols.smb
 107 newsgroup or the mailing list that we will read it. If you suspect that your
 108 problem is not a bug but a configuration problem then it is better to send
 109 it to the Samba mailing list, as there are (at last count) 5000 other users on
 110 that list that may be able to help you.</P
 111 ><P
 112 >You may also like to look though the recent mailing list archives,
 113 which are conveniently accessible on the Samba web pages
 114 at <A
 115 HREF="http://samba.org/samba/"
 116 TARGET="_top"
 117 >http://samba.org/samba/</A
 118 >.</P
 119 ></DIV
 120 ><DIV
 121 CLASS="SECT1"
 122 ><H1
 123 CLASS="SECT1"
 124 ><A
 125 NAME="AEN3319">25.2. General info</H1
 126 ><P
 127 >Before submitting a bug report check your config for silly
 128 errors. Look in your log files for obvious messages that tell you that
 129 you've misconfigured something and run testparm to test your config
 130 file for correct syntax.</P
 131 ><P
 132 >Have you run through the <A
 133 HREF="Diagnosis.html"
 134 TARGET="_top"
 135 >diagnosis</A
 136 >?
 137 This is very important.</P
 138 ><P
 139 >If you include part of a log file with your bug report then be sure to
 140 annotate it with exactly what you were doing on the client at the
 141 time, and exactly what the results were.</P
 142 ></DIV
 143 ><DIV
 144 CLASS="SECT1"
 145 ><H1
 146 CLASS="SECT1"
 147 ><A
 148 NAME="AEN3325">25.3. Debug levels</H1
 149 ><P
 150 >If the bug has anything to do with Samba behaving incorrectly as a
 151 server (like refusing to open a file) then the log files will probably
 152 be very useful. Depending on the problem a log level of between 3 and
 153 10 showing the problem may be appropriate. A higher level givesmore
 154 detail, but may use too much disk space.</P
 155 ><P
 156 >To set the debug level use <B
 157 CLASS="COMMAND"
 158 >log level =</B
 159 > in your
 160 <TT
 161 CLASS="FILENAME"
 162 >smb.conf</TT
 163 >. You may also find it useful to set the log
 164 level higher for just one machine and keep separate logs for each machine.
 165 To do this use:</P
 166 ><P
 167 ><PRE
 168 CLASS="PROGRAMLISTING"
 169 >log level = 10
 170 log file = /usr/local/samba/lib/log.%m
 171 include = /usr/local/samba/lib/smb.conf.%m</PRE
 172 ></P
 173 ><P
 174 >then create a file
 175 <TT
 176 CLASS="FILENAME"
 177 >/usr/local/samba/lib/smb.conf.machine</TT
 178 > where
 179 "machine" is the name of the client you wish to debug. In that file
 180 put any smb.conf commands you want, for example
 181 <B
 182 CLASS="COMMAND"
 183 >log level=</B
 184 > may be useful. This also allows you to
 185 experiment with different security systems, protocol levels etc on just
 186 one machine.</P
 187 ><P
 188 >The <TT
 189 CLASS="FILENAME"
 190 >smb.conf</TT
 191 > entry <B
 192 CLASS="COMMAND"
 193 >log level =</B
 194 >
 195 is synonymous with the entry <B
 196 CLASS="COMMAND"
 197 >debuglevel =</B
 198 > that has been
 199 used in older versions of Samba and is being retained for backwards
 200 compatibility of smb.conf files.</P
 201 ><P
 202 >As the <B
 203 CLASS="COMMAND"
 204 >log level =</B
 205 > value is increased you will record
 206 a significantly increasing level of debugging information. For most
 207 debugging operations you may not need a setting higher than 3. Nearly
 208 all bugs can be tracked at a setting of 10, but be prepared for a VERY
 209 large volume of log data.</P
 210 ></DIV
 211 ><DIV
 212 CLASS="SECT1"
 213 ><H1
 214 CLASS="SECT1"
 215 ><A
 216 NAME="AEN3342">25.4. Internal errors</H1
 217 ><P
 218 >If you get a "INTERNAL ERROR" message in your log files it means that
 219 Samba got an unexpected signal while running. It is probably a
 220 segmentation fault and almost certainly means a bug in Samba (unless
 221 you have faulty hardware or system software)</P
 222 ><P
 223 >If the message came from smbd then it will probably be accompanied by
 224 a message which details the last SMB message received by smbd. This
 225 info is often very useful in tracking down the problem so please
 226 include it in your bug report.</P
 227 ><P
 228 >You should also detail how to reproduce the problem, if
 229 possible. Please make this reasonably detailed.</P
 230 ><P
 231 >You may also find that a core file appeared in a "corefiles"
 232 subdirectory of the directory where you keep your samba log
 233 files. This file is the most useful tool for tracking down the bug. To
 234 use it you do this:</P
 235 ><P
 236 ><B
 237 CLASS="COMMAND"
 238 >gdb smbd core</B
 239 ></P
 240 ><P
 241 >adding appropriate paths to smbd and core so gdb can find them. If you
 242 don't have gdb then try "dbx". Then within the debugger use the
 243 command "where" to give a stack trace of where the problem
 244 occurred. Include this in your mail.</P
 245 ><P
 246 >If you known any assembly language then do a "disass" of the routine
 247 where the problem occurred (if its in a library routine then
 248 disassemble the routine that called it) and try to work out exactly
 249 where the problem is by looking at the surrounding code. Even if you
 250 don't know assembly then incuding this info in the bug report can be
 251 useful. </P
 252 ></DIV
 253 ><DIV
 254 CLASS="SECT1"
 255 ><H1
 256 CLASS="SECT1"
 257 ><A
 258 NAME="AEN3352">25.5. Attaching to a running process</H1
 259 ><P
 260 >Unfortunately some unixes (in particular some recent linux kernels)
 261 refuse to dump a core file if the task has changed uid (which smbd
 262 does often). To debug with this sort of system you could try to attach
 263 to the running process using "gdb smbd PID" where you get PID from
 264 smbstatus. Then use "c" to continue and try to cause the core dump
 265 using the client. The debugger should catch the fault and tell you
 266 where it occurred.</P
 267 ></DIV
 268 ><DIV
 269 CLASS="SECT1"
 270 ><H1
 271 CLASS="SECT1"
 272 ><A
 273 NAME="AEN3355">25.6. Patches</H1
 274 ><P
 275 >The best sort of bug report is one that includes a fix! If you send us
 276 patches please use <B
 277 CLASS="COMMAND"
 278 >diff -u</B
 279 > format if your version of
 280 diff supports it, otherwise use <B
 281 CLASS="COMMAND"
 282 >diff -c4</B
 283 >. Make sure
 284 your do the diff against a clean version of the source and let me know
 285 exactly what version you used. </P
 286 ></DIV
 287 ></DIV
 288 ><DIV
 289 CLASS="NAVFOOTER"
 290 ><HR
 291 ALIGN="LEFT"
 292 WIDTH="100%"><TABLE
 293 SUMMARY="Footer navigation table"
 294 WIDTH="100%"
 295 BORDER="0"
 296 CELLPADDING="0"
 297 CELLSPACING="0"
 298 ><TR
 299 ><TD
 300 WIDTH="33%"
 301 ALIGN="left"
 302 VALIGN="top"
 303 ><A
 304 HREF="other-clients.html"
 305 ACCESSKEY="P"
 306 >Prev</A
 307 ></TD
 308 ><TD
 309 WIDTH="34%"
 310 ALIGN="center"
 311 VALIGN="top"
 312 ><A
 313 HREF="samba-howto-collection.html"
 314 ACCESSKEY="H"
 315 >Home</A
 316 ></TD
 317 ><TD
 318 WIDTH="33%"
 319 ALIGN="right"
 320 VALIGN="top"
 321 ><A
 322 HREF="diagnosis.html"
 323 ACCESSKEY="N"
 324 >Next</A
 325 ></TD
 326 ></TR
 327 ><TR
 328 ><TD
 329 WIDTH="33%"
 330 ALIGN="left"
 331 VALIGN="top"
 332 >Samba and other CIFS clients</TD
 333 ><TD
 334 WIDTH="34%"
 335 ALIGN="center"
 336 VALIGN="top"
 337 ><A
 338 HREF="appendixes.html"
 339 ACCESSKEY="U"
 340 >Up</A
 341 ></TD
 342 ><TD
 343 WIDTH="33%"
 344 ALIGN="right"
 345 VALIGN="top"
 346 >Diagnosing your samba server</TD
 347 ></TR
 348 ></TABLE
 349 ></DIV
 350 ></BODY
 351 ></HTML
 352 >