doc/bugs

   1 BUGS
   2
   3 0.INTRODUCTION
   4
   5   The FreeRADIUS web site is at <URL: http://www.freeradius.org>, and
   6   most information referenced in this document can be found there.
   7
   8   This is primarily for non-developers of the FreeRADIUS server. If you are
   9   able to patch the code to work correctly, then we invite you to join the
  10   development list to discuss it. If you're the type who know little about
  11   how to code, then this is the place for you!
  12
  13 1.YOU FOUND A BUG
  14
  15   So you think you've found a bug in the FreeRADIUS server?
  16
  17   You should first discuss it on the users list, to see if anyone can
  18   reproduce it. Often there's a simple explanation of why the server
  19   behaves as it does, and it's not necessarily a bug in the code, so
  20   browse the lists' archives of the last two months, and if you don't
  21   see messages about it, ask!
  22
  23   If the behavior is correct but confusing, we think that's a bug too, and
  24   you should file a bug against our documentation.
  25
  26   For more information about the users list, the lists' archives and the
  27   faq, please visit http://www.freeradius.org/list/users.html
  28   Please make sure to READ and RESPECT the house-rules. You will get much
  29   better response and much faster if you do!
  30
  31 2.CORE DUMPS
  32
  33   If the server, or one of the accompyaning programs core dumps, then
  34   you should rebuild the server as follows:
  35
  36   $ ./configure --enable-developer
  37   $ make
  38   $ make install
  39
  40   and then run the program again. You may have to to enable core
  41   dumps, via:
  42
  43   $ ulimit -c unlimited
  44
  45   When it core dumps, do:
  46
  47   $ gdb /path/to/executable /path/to/core/file
  48
  49   And then in 'gdb', do:
  50
  51   $ bt
  52
  53   Copy the output, and mail it to the list, along with the name of the
  54   program you were running, and the name of the operating system.
  55   Without this information, it's impossible for anyone to know why the
  56   program core dumped.
  57
  58   You can also submit the information to the bug database at:
  59
  60     http://bugs.freeradius.org/
  61
  62   Submitting it to the bug database ensures that the bug report won't
  63   get forgotten, and that someone will eventually respond to it.
  64
  65 --
  66
  67 FreeRADIUS Project, copyright 2004
  68 $Id$