~ubuntu-branches/ubuntu/vivid/samba/vivid

« back to all changes in this revision

Viewing changes to source3/lib/ldb/README_gcov.txt

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2011-12-21 13:18:04 UTC
  • mfrom: (0.39.21 sid)
  • Revision ID: package-import@ubuntu.com-20111221131804-xtlr39wx6njehxxr
Tags: 2:3.6.1-3ubuntu1
* Merge from Debian testing.  Remaining changes:
  + debian/patches/VERSION.patch:
    - set SAMBA_VERSION_SUFFIX to Ubuntu.
  + debian/patches/error-trans.fix-276472:
    - Add the translation of Unix Error code -ENOTSUP to NT Error Code
    - NT_STATUS_NOT_SUPPORTED to prevent the Permission denied error.
  + debian/smb.conf:
    - add "(Samba, Ubuntu)" to server string.
    - comment out the default [homes] share, and add a comment about
      "valid users = %S" to show users how to restrict access to
      \\server\username to only username.
    - Set 'usershare allow guests', so that usershare admins are 
      allowed to create public shares in addition to authenticated
      ones.
    - add map to guest = Bad user, maps bad username to guest access.
  + debian/samba-common.config:
    - Do not change priority to high if dhclient3 is installed.
    - Use priority medium instead of high for the workgroup question.
  + debian/control:
    - Don't build against or suggest ctdb.
    - Add dependency on samba-common-bin to samba.
  + Add ufw integration:
    - Created debian/samba.ufw.profile
    - debian/rules, debian/samba.dirs, debian/samba.files: install
      profile
    - debian/control: have samba suggest ufw
  + Add apport hook:
    - Created debian/source_samba.py.
    - debian/rules, debian/samba.dirs, debian/samba-common-bin.files: install
  + Switch to upstart:
    - Add debian/samba.{nmbd,smbd}.upstart.
  + debian/samba.logrotate, debian/samba-common.dhcp, debian/samba.if-up:
    - Make them upstart compatible
  + debian/samba.postinst: 
    - Avoid scary pdbedit warnings on first import.
  + debian/samba-common.postinst: Add more informative error message for
    the case where smb.conf was manually deleted
  + debian/patches/fix-debuglevel-name-conflict.patch: don't use 'debug_level'
    as a global variable name in an NSS module 
  + Dropped:
    - debian/patches/error-trans.fix-276472
    - debian/patches/fix-debuglevel-name-conflict.patch

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
Here is how to use gcov to test code coverage in ldb.
2
 
 
3
 
Step 1: build ldb with gcov enabled
4
 
 
5
 
     make clean all WITH_GCOV=1
6
 
 
7
 
Step 3: run the test suite
8
 
     make test-tdb
9
 
 
10
 
Step 4: produce the gcov report
11
 
     make gcov
12
 
 
13
 
Step 5: read the summary reports
14
 
     less *.report.gcov
15
 
 
16
 
Step 6: examine the per-file reports
17
 
     less ldb_tdb\#ldb_tdb.c.gcov
18
 
 
19
 
You can also combine steps 2 to 4 like this:
20
 
 
21
 
     make clean all test-tdb gcov WITH_GCOV=1
22
 
 
23
 
Note that you should not expect 100% coverage, as some error paths
24
 
(such as memory allocation failures) are very hard to trigger. There
25
 
are ways of working around this, but they are quite tricky (they
26
 
involve allocation wrappers that "fork and fail on malloc").
27
 
 
28
 
The lines to look for in the per-file reports are the ones starting
29
 
with "#####". Those are lines that are never executed.