summaryrefslogtreecommitdiff
path: root/docs/htmldocs/bugreport.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/htmldocs/bugreport.html')
-rw-r--r--docs/htmldocs/bugreport.html123
1 files changed, 36 insertions, 87 deletions
diff --git a/docs/htmldocs/bugreport.html b/docs/htmldocs/bugreport.html
index 516d187e6a..fcc4b7e91a 100644
--- a/docs/htmldocs/bugreport.html
+++ b/docs/htmldocs/bugreport.html
@@ -5,7 +5,8 @@
>Reporting Bugs</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
+"><LINK
REL="HOME"
TITLE="SAMBA Project Documentation"
HREF="samba-howto-collection.html"><LINK
@@ -13,10 +14,10 @@ REL="UP"
TITLE="Appendixes"
HREF="appendixes.html"><LINK
REL="PREVIOUS"
-TITLE="How to compile SAMBA"
-HREF="compiling.html"><LINK
+TITLE="Samba and other CIFS clients"
+HREF="other-clients.html"><LINK
REL="NEXT"
-TITLE="The samba checklist"
+TITLE="Diagnosing your samba server"
HREF="diagnosis.html"></HEAD
><BODY
CLASS="CHAPTER"
@@ -45,7 +46,7 @@ WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
-HREF="compiling.html"
+HREF="other-clients.html"
ACCESSKEY="P"
>Prev</A
></TD
@@ -72,20 +73,16 @@ WIDTH="100%"></DIV
CLASS="CHAPTER"
><H1
><A
-NAME="BUGREPORT"
-></A
->Chapter 32. Reporting Bugs</H1
+NAME="BUGREPORT">Chapter 25. Reporting Bugs</H1
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
-NAME="AEN4634"
->32.1. Introduction</A
-></H1
+NAME="AEN3309">25.1. Introduction</H1
><P
>The email address for bug reports for stable releases is <A
-HREF="mailto:samba@samba.org"
+HREF="samba@samba.org"
TARGET="_top"
>samba@samba.org</A
>.
@@ -125,9 +122,7 @@ CLASS="SECT1"
><H1
CLASS="SECT1"
><A
-NAME="AEN4644"
->32.2. General info</A
-></H1
+NAME="AEN3319">25.2. General info</H1
><P
>Before submitting a bug report check your config for silly
errors. Look in your log files for obvious messages that tell you that
@@ -135,7 +130,8 @@ you've misconfigured something and run testparm to test your config
file for correct syntax.</P
><P
>Have you run through the <A
-HREF="diagnosis.html"
+HREF="Diagnosis.html"
+TARGET="_top"
>diagnosis</A
>?
This is very important.</P
@@ -149,9 +145,7 @@ CLASS="SECT1"
><H1
CLASS="SECT1"
><A
-NAME="AEN4650"
->32.3. Debug levels</A
-></H1
+NAME="AEN3325">25.3. Debug levels</H1
><P
>If the bug has anything to do with Samba behaving incorrectly as a
server (like refusing to open a file) then the log files will probably
@@ -180,19 +174,10 @@ include = /usr/local/samba/lib/smb.conf.%m</PRE
>then create a file
<TT
CLASS="FILENAME"
->/usr/local/samba/lib/smb.conf.<VAR
-CLASS="REPLACEABLE"
->machine</VAR
-></TT
+>/usr/local/samba/lib/smb.conf.machine</TT
> where
-<VAR
-CLASS="REPLACEABLE"
->machine</VAR
-> is the name of the client you wish to debug. In that file
-put any <TT
-CLASS="FILENAME"
->smb.conf</TT
-> commands you want, for example
+"machine" is the name of the client you wish to debug. In that file
+put any smb.conf commands you want, for example
<B
CLASS="COMMAND"
>log level=</B
@@ -212,10 +197,7 @@ CLASS="COMMAND"
>debuglevel =</B
> that has been
used in older versions of Samba and is being retained for backwards
-compatibility of <TT
-CLASS="FILENAME"
->smb.conf</TT
-> files.</P
+compatibility of smb.conf files.</P
><P
>As the <B
CLASS="COMMAND"
@@ -231,14 +213,12 @@ CLASS="SECT1"
><H1
CLASS="SECT1"
><A
-NAME="AEN4671"
->32.4. Internal errors</A
-></H1
+NAME="AEN3342">25.4. Internal errors</H1
><P
>If you get a "INTERNAL ERROR" message in your log files it means that
Samba got an unexpected signal while running. It is probably a
segmentation fault and almost certainly means a bug in Samba (unless
-you have faulty hardware or system software).</P
+you have faulty hardware or system software)</P
><P
>If the message came from smbd then it will probably be accompanied by
a message which details the last SMB message received by smbd. This
@@ -248,10 +228,7 @@ include it in your bug report.</P
>You should also detail how to reproduce the problem, if
possible. Please make this reasonably detailed.</P
><P
->You may also find that a core file appeared in a <TT
-CLASS="FILENAME"
->corefiles</TT
->
+>You may also find that a core file appeared in a "corefiles"
subdirectory of the directory where you keep your samba log
files. This file is the most useful tool for tracking down the bug. To
use it you do this:</P
@@ -262,20 +239,11 @@ CLASS="COMMAND"
></P
><P
>adding appropriate paths to smbd and core so gdb can find them. If you
-don't have gdb then try <KBD
-CLASS="USERINPUT"
->dbx</KBD
->. Then within the debugger use the
-command <KBD
-CLASS="USERINPUT"
->where</KBD
-> to give a stack trace of where the problem
+don't have gdb then try "dbx". Then within the debugger use the
+command "where" to give a stack trace of where the problem
occurred. Include this in your mail.</P
><P
->If you known any assembly language then do a <KBD
-CLASS="USERINPUT"
->disass</KBD
-> of the routine
+>If you known any assembly language then do a "disass" of the routine
where the problem occurred (if its in a library routine then
disassemble the routine that called it) and try to work out exactly
where the problem is by looking at the surrounding code. Even if you
@@ -287,30 +255,13 @@ CLASS="SECT1"
><H1
CLASS="SECT1"
><A
-NAME="AEN4685"
->32.5. Attaching to a running process</A
-></H1
+NAME="AEN3352">25.5. Attaching to a running process</H1
><P
>Unfortunately some unixes (in particular some recent linux kernels)
refuse to dump a core file if the task has changed uid (which smbd
does often). To debug with this sort of system you could try to attach
-to the running process using <KBD
-CLASS="USERINPUT"
->gdb smbd <VAR
-CLASS="REPLACEABLE"
->PID</VAR
-></KBD
-> where you get <VAR
-CLASS="REPLACEABLE"
->PID</VAR
-> from
-<SPAN
-CLASS="APPLICATION"
->smbstatus</SPAN
->. Then use <KBD
-CLASS="USERINPUT"
->c</KBD
-> to continue and try to cause the core dump
+to the running process using "gdb smbd PID" where you get PID from
+smbstatus. Then use "c" to continue and try to cause the core dump
using the client. The debugger should catch the fault and tell you
where it occurred.</P
></DIV
@@ -319,18 +270,16 @@ CLASS="SECT1"
><H1
CLASS="SECT1"
><A
-NAME="AEN4693"
->32.6. Patches</A
-></H1
+NAME="AEN3355">25.6. Patches</H1
><P
>The best sort of bug report is one that includes a fix! If you send us
-patches please use <KBD
-CLASS="USERINPUT"
->diff -u</KBD
+patches please use <B
+CLASS="COMMAND"
+>diff -u</B
> format if your version of
-diff supports it, otherwise use <KBD
-CLASS="USERINPUT"
->diff -c4</KBD
+diff supports it, otherwise use <B
+CLASS="COMMAND"
+>diff -c4</B
>. Make sure
your do the diff against a clean version of the source and let me know
exactly what version you used. </P
@@ -352,7 +301,7 @@ WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
-HREF="compiling.html"
+HREF="other-clients.html"
ACCESSKEY="P"
>Prev</A
></TD
@@ -380,7 +329,7 @@ ACCESSKEY="N"
WIDTH="33%"
ALIGN="left"
VALIGN="top"
->How to compile SAMBA</TD
+>Samba and other CIFS clients</TD
><TD
WIDTH="34%"
ALIGN="center"
@@ -394,7 +343,7 @@ ACCESSKEY="U"
WIDTH="33%"
ALIGN="right"
VALIGN="top"
->The samba checklist</TD
+>Diagnosing your samba server</TD
></TR
></TABLE
></DIV