packaging/Debian/debian/README.debian

   1 Samba for Debian
   2 ----------------
   3
   4 This package was built by Eloy Paris <peloy@debian.org> and Steve Langasek
   5 <vorlon@debian.org>, current maintainers of the Samba packages for Debian,
   6 based on previous work from Bruce Perens <Bruce@Pixar.com>, Andrew
   7 Howell <andrew@it.com.au>, Klee Dienes <klee@debian.org> and Michael
   8 Meskes <meskes@topsystem.de>, all previous maintainers of the packages
   9 samba and sambades (merged together for longer than we can remember.)
  10
  11 Contents of this README file:
  12
  13 1. Notes
  14 2. Packages Generated from the Samba Sources
  15 3. Support for NT Domains
  16 4. Samba and LDAP
  17 5. Reporting bugs
  18
  19
  20 1. Notes
  21 --------
  22
  23 - As of Samba 2.0.6-1, the Debian version of Samba is compiled with
  24   Pluggable Authentication Modules (PAM) support. PAM support was
  25   discontinued during the libc5 -> libc6 migration process and I never
  26   brought it back until 2.0.6-1.
  27
  28 - The smbfs package does not support the 2.0.x Linux kernels anymore.
  29   This has been the case since the very first packages of the CVS sources
  30   that eventually became Samba 2.2. To use the smbfs package you need to
  31   run a 2.2.x kernel or later.
  32
  33 - Starting with the Debian packages for Samba 2.2, the Samba log files (for
  34   nmbd and smbd) have been moved to a new location: /var/log/samba/. The
  35   files also have new names: log.nmbd and log.smbd. The old files
  36   (/var/log/{nmb,smb} were moved to the new location.
  37
  38
  39 2. Packages Generated from the Samba Sources
  40 --------------------------------------------
  41
  42 Currently, the Samba sources produce the following binary packages:
  43
  44 samba: A LanManager like file and printer server for Unix.
  45 samba-common: Samba common files used by both the server and the client.
  46 smbclient: A LanManager like simple client for Unix.
  47 swat: Samba Web Administration Tool
  48 samba-doc: Samba documentation.
  49 smbfs: Mount and umount commands for the smbfs (works with 2.2.x and
  50         above kernels, not with 2.0.x kernels.)
  51 libpam-smbpass: pluggable authentication module for SMB password
  52         database.
  53 libsmbclient: Shared library that allows applications to talk to SMB servers.
  54 libsmbclient-dev: libsmbclient shared libraries.
  55 winbind: Service to resolve user and group information from a Windows NT
  56         server.
  57
  58 Please note that the package smbwrapper (a shared library that provides
  59 SMB client services that existed between Samba 2.0.0-1 and Samba-2.0.5a-4
  60 does not exist any more. The reason is that starting with Samba 2.0.6-1, that
  61 code does not even compile, and the upstream author (Andrew Tridgell)
  62 recommended to disable the compilation of smbwrapper until some issues
  63 with glibc2.1 get cleared out (the problem is with glibc, not with Samba
  64 itself).
  65
  66
  67 3. Support for NT Domains
  68 -------------------------
  69
  70 Samba 2.2 includes preliminary support for NT domains. A Samba server
  71 can now be part of a Windows NT domain whose Primary Domain Controller
  72 is a Windows NT server. This feature is supposed to be stable although I
  73 haven't tried it myself. Read the documentation in the samba-doc package
  74 for help on how to do this (hint: "security = domain" in the smb.conf
  75 file).
  76
  77 Samba 2.2 has also experimental support for Primary Domain
  78 Controller. This means that a Samba server can act now as a PDC. There
  79 are no special flags needed to compile Samba with NT domain PDC
  80 support. Please read the NTDOM PDC FAQ at www.samba.org (Documentation
  81 section).
  82
  83 Please note that NT domain PDC support is far from complete and is still
  84 experimental.
  85
  86
  87 4. Samba and LDAP
  88 -----------------
  89
  90 Samba 2.2 has experimental LDAP code. However, the official Debian
  91 packages have not been compiled with LDAP support for a good reason: if
  92 LDAP support is compiled in then the other authentication methods (PAM,
  93 smbpasswd, etc.) cannot be used, only LDAP will work. So, until LDAP
  94 can coexist peacefully with the other methods we will not provide
  95 LDAP-enabled packages. The workaround is, of course, to build your own
  96 packages. We can help with this if you don't know how to build packages.
  97
  98 We follow Samba development, so please do not file bug reports asking
  99 for LDAP; we will add support for it when it doesn't break other
 100 things.
 101
 102
 103 5. Reporting Bugs
 104 -----------------
 105
 106 If you believe you have found a bug please make sure the possible bug
 107 also exists in the latest version of Samba that is available for the
 108 unstable Debian distribution. If you are running Debian stable this
 109 means that you will probably have to build your own packages. And if the
 110 problem does not exist in the latest version of Samba we have packaged it
 111 means that you will have to run the version of Samba you built yourself
 112 since it is not easy to upload new packages to the stable distribution,
 113 unless they fix critical security problems.
 114
 115 If you can reproduce the problem in the latest version of Samba then
 116 it is likely to be a real bug. Your best shot is to search the Samba
 117 mailing lists to see if it is something that has already been reported
 118 and fixed - if it is a simple fix we can add the patch to our packages
 119 without waiting for a new Samba release.
 120
 121 If you decide that your problem deserves to be submitted to the Debian
 122 Bug Tracking System (BTS) we expect you to be responsive if we request
 123 more information. If we request more information and do not receive
 124 any in a reasonable time frame expect to see your bug closed without
 125 explanation - we can't fix bugs we can't reproduce, and most of the
 126 time we need more information to be able to reproduce them.
 127
 128 When submitting a bug to the Debian BTS please include the version of
 129 the Debian package you are using as well as the Debian distribution you
 130 are using. Think _twice_ about the severity you assign to the bug: we
 131 are _very_ sensitive about bug severities; the fact that it doesn't
 132 work for you doesn't mean that the severity must be such that it holds
 133 a major Debian release. In fact, that it doesn't work for you it
 134 doesn't mean that it doesn't work for others. So again: think _twice_.
 135
 136
 137 Eloy A. Paris <peloy@debian.org>
 138 Steve Langasek <vorlon@debian.org>
 139