← Back to branch summary

~ubuntu-branches/ubuntu/precise/open-iscsi/precise-backports

« back to all changes in this revision

Viewing changes to utils/open-isns/HACKING

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2013-09-20 09:07:42 UTC
  • mfrom: (37.1.5 quantal-proposed)
  • Revision ID: package-import@ubuntu.com-20130920090742-rv5qfxabddc9dk2h
Tags: 2.0.873-3ubuntu5~ubuntu12.04.1
https://launchpad.net/bugs/1228046
No-change backport to precise (LP: #1228046)

Show diffs side-by-side

added added

removed removed

Lines of Context:
utils/open-isns/HACKING
 
1
 
 
2
When hacking on open-isns, or when trying to locate a problem,
 
3
the following information may be useful:
 
4
 
 
5
 -      You can start the daemon using the -f option, which
 
6
        prevents it from backgrounding itself. Crucial if
 
7
        you want to run it in a debugger, or under strace.
 
8
 
 
9
        This option works for isnsd and isnsdd
 
10
 
 
11
 -      All tools support the "-d" option to enable debugging.
 
12
        In general, you want to use "-d all" to turn on all
 
13
        debugging options. However, you can select individual
 
14
        debug facilities - check out the manpages and/or
 
15
        the source code in logging.c
 
16
 
 
17
 -      If isnsd crashes, and you suspect memory corruption,
 
18
        you can compile open-isns with memory debugging enabled.  Re-run
 
19
        the configure script and add the option --enable-memdebug. Then
 
20
        run "make clean all" to rebuild everything.
 
21
 
 
22
        Memory debugging can be chosen at run-time by setting the
 
23
        ISNS_MDEBUG environment variable, and re-starting the application:
 
24
 
 
25
        export ISNS_MDEBUG=1
 
26
        ./isnsd -f -d all
 
27
 
 
28
        Memory debugging works for all memory allocations done by the
 
29
        Open-iSNS code, but does not affect memory allocations by other
 
30
        libraries (such as glibc or openssl).