source4/NEWS

   1 This file aims to document the major changes since the latest released version
   2 of Samba, 3.0. Samba 4.0 contains rewrites of several subsystems
   3 and uses a different internal format for most data. Since this
   4 file is an initial draft, please update missing items.
   5
   6 One of the main goals of Samba 4 was Active Directory Domain Controller
   7 support. This means Samba now implements several protocols that are required
   8 by AD such as Kerberos and DNS.
   9
  10 An (experimental) upgrade script that performs a one-way upgrade
  11 from Samba 3 is available in source/setup/upgrade.
  12
  13 Removal of nmbd and introduction of process models
  14 ==================================================
  15 smbd now implements several network protocols other than just CIFS and
  16 DCE/RPC. nmbd's functionality has been merged into smbd. smbd supports
  17 various 'process models' that specify how concurrent connections are
  18 handled (when to fork, use threads, etc).
  19
  20 Introduction of LDB
  21 ===================
  22 Samba now stores most of its persistent data in a LDAP-like database
  23 called LDB (see ldb(7) for more info).
  24
  25 Removed SWAT
  26 ==================
  27 Unlike previous versions, Samba4 does not provide a web interface at this time.
  28
  29 Built-in KDC
  30 ============
  31 Samba4 ships with an integrated KDC (Kerberos Key Distribution
  32 Center).  Backed directly onto our main internal database, and
  33 integrated with custom code to handle the PAC, Samba4's KDC is an
  34 integral part of our support for AD logon protocols.
  35
  36 Built-in LDAP Server
  37 ====================
  38 Like the situation with the KDC, Samba4 ships with it's own LDAP
  39 server, included to provide simple, built-in LDAP services in an AD
  40 (rather than distinctly standards) matching manner.  The database is
  41 LDB, and it shares that in common with the rest of Samba.
  42
  43 Changed configuration options
  44 =============================
  45 Several configuration options have been removed in Samba4 while others have
  46 been introduced. This section contains a summary of changes to smb.conf and
  47 where these settings moved. Configuration options that have disappeared may be
  48 re-added later when the functionality that uses them gets reimplemented in
  49 Samba 4.
  50
  51 The 'security' parameter has been split up. It is now only used to choose
  52 between the 'user' and 'share' security levels (the latter is not supported
  53 in Samba 4 yet). The other values of this option and the 'domain master' and
  54 'domain logons' parameters have been merged into a 'server role' parameter
  55 that can be either 'domain controller', 'member server' or 'standalone'. Note that
  56 member server support does not work yet.
  57
  58 The following parameters have been removed:
  59 - passdb backend: accounts are now stored in a LDB-based SAM database,
  60         see 'sam database' below.
  61 - update encrypted
  62 - public
  63 - guest ok
  64 - client schannel
  65 - server schannel
  66 - allow trusted domains
  67 - hosts equiv
  68 - map to guest
  69 - smb passwd file
  70 - algorithmic rid base
  71 - root directory
  72 - root dir
  73 - root
  74 - guest account
  75 - enable privileges
  76 - pam password change
  77 - passwd program
  78 - passwd chat debug
  79 - passwd chat timeout
  80 - check password script
  81 - username map
  82 - username level
  83 - unix password sync
  84 - restrict anonymous
  85 - username
  86 - user
  87 - users
  88 - invalid users
  89 - valid users
  90 - admin users
  91 - read list
  92 - write list
  93 - printer admin
  94 - force user
  95 - force group
  96 - group
  97 - write ok
  98 - writeable
  99 - writable
 100 - acl check permissions
 101 - acl group control
 102 - acl map full control
 103 - create mask
 104 - create mode
 105 - force create mode
 106 - security mask
 107 - force security mode
 108 - directory mask
 109 - directory mode
 110 - force directory mode
 111 - directory security mask
 112 - force directory security mode
 113 - force unknown acl user
 114 - inherit permissions
 115 - inherit acls
 116 - inherit owner
 117 - guest only
 118 - only guest
 119 - only user
 120 - allow hosts
 121 - deny hosts
 122 - preload modules
 123 - use kerberos keytab
 124 - syslog
 125 - syslog only
 126 - max log size
 127 - debug timestamp
 128 - timestamp logs
 129 - debug hires timestamp
 130 - debug pid
 131 - debug uid
 132 - allocation roundup size
 133 - aio read size
 134 - aio write size
 135 - aio write behind
 136 - large readwrite
 137 - protocol
 138 - read bmpx
 139 - reset on zero vc
 140 - acl compatibility
 141 - defer sharing violations
 142 - ea support
 143 - nt acl support
 144 - nt pipe support
 145 - profile acls
 146 - map acl inherit
 147 - afs share
 148 - max ttl
 149 - client use spnego
 150 - enable asu support
 151 - svcctl list
 152 - block size
 153 - change notify timeout
 154 - deadtime
 155 - getwd cache
 156 - keepalive
 157 - kernel change notify
 158 - lpq cache time
 159 - max smbd processes
 160 - max disk size
 161 - max open files
 162 - min print space
 163 - strict allocate
 164 - sync always
 165 - use mmap
 166 - use sendfile
 167 - hostname lookups
 168 - write cache size
 169 - name cache timeout
 170 - max reported print jobs
 171 - load printers
 172 - printcap cache time
 173 - printcap name
 174 - printcap
 175 - printing
 176 - cups options
 177 - cups server
 178 - iprint server
 179 - print command
 180 - disable spoolss
 181 - enable spoolss
 182 - lpq command
 183 - lprm command
 184 - lppause command
 185 - lpresume command
 186 - queuepause command
 187 - queueresume command
 188 - enumports command
 189 - addprinter command
 190 - deleteprinter command
 191 - show add printer wizard
 192 - os2 driver map
 193 - use client driver
 194 - default devmode
 195 - force printername
 196 - mangling method
 197 - mangle prefix
 198 - default case
 199 - case sensitive
 200 - casesignames
 201 - preserve case
 202 - short preserve case
 203 - mangling char
 204 - hide dot files
 205 - hide special files
 206 - hide unreadable
 207 - hide unwriteable files
 208 - delete veto files
 209 - veto files
 210 - hide files
 211 - veto oplock files
 212 - map readonly
 213 - mangled names
 214 - mangled map
 215 - max stat cache size
 216 - stat cache
 217 - store dos attributes
 218 - machine password timeout
 219 - add user script
 220 - rename user script
 221 - delete user script
 222 - add group script
 223 - delete group script
 224 - add user to group script
 225 - delete user from group script
 226 - set primary group script
 227 - add machine script
 228 - shutdown script
 229 - abort shutdown script
 230 - username map script
 231 - logon script
 232 - logon path
 233 - logon drive
 234 - logon home
 235 - domain logons
 236 - os level
 237 - lm announce
 238 - lm interval
 239 - domain master
 240 - browse list
 241 - enhanced browsing
 242 - wins proxy
 243 - wins hook
 244 - wins partners
 245 - blocking locks
 246 - fake oplocks
 247 - kernel oplocks
 248 - locking
 249 - lock spin count
 250 - lock spin time
 251 - level2 oplocks
 252 - oplock break wait time
 253 - oplock contention limit
 254 - posix locking
 255 - share modes
 256 - ldap server
 257 - ldap port
 258 - ldap admin dn
 259 - ldap delete dn
 260 - ldap group suffix
 261 - ldap idmap suffix
 262 - ldap machine suffix
 263 - ldap passwd sync
 264 - ldap password sync
 265 - ldap replication sleep
 266 - ldap suffix
 267 - ldap ssl
 268 - ldap timeout
 269 - ldap page size
 270 - ldap user suffix
 271 - add share command
 272 - change share command
 273 - delete share command
 274 - eventlog list
 275 - utmp directory
 276 - wtmp directory
 277 - utmp
 278 - default service
 279 - default
 280 - message command
 281 - dfree cache time
 282 - dfree command
 283 - get quota command
 284 - set quota command
 285 - remote announce
 286 - remote browse sync
 287 - homedir map
 288 - afs username map
 289 - afs token lifetime
 290 - log nt token command
 291 - time offset
 292 - NIS homedir
 293 - preexec
 294 - exec
 295 - preexec close
 296 - postexec
 297 - root preexec
 298 - root preexec close
 299 - root postexec
 300 - set directory
 301 - wide links
 302 - follow symlinks
 303 - dont descend
 304 - magic script
 305 - magic output
 306 - delete readonly
 307 - dos filemode
 308 - dos filetimes
 309 - dos filetime resolution
 310 - fake directory create times
 311 - panic action
 312 - vfs objects
 313 - vfs object
 314 - msdfs root
 315 - msdfs proxy
 316 - host msdfs
 317 - enable rid algorithm
 318 - passdb expand explicit
 319 - idmap backend
 320 - idmap uid
 321 - winbind uid
 322 - idmap gid
 323 - winbind gid
 324 - template homedir
 325 - template shell
 326 - winbind separator
 327 - winbind cache time
 328 - winbind enum users
 329 - winbind enum groups
 330 - winbind use default domain
 331 - winbind trusted domains only
 332 - winbind nested groups
 333 - winbind max idle children
 334 - winbind nss info
 335
 336 The following parameters have been added:
 337 + rpc big endian (G)
 338         Make Samba fake it is running on a bigendian machine when using DCE/RPC.
 339         Useful for debugging.
 340
 341         Default: no
 342
 343 + case insensitive filesystem (S)
 344         Set to true if this share is located on a case-insensitive filesystem.
 345         This disables looking for a filename by trying all possible combinations of
 346         uppercase/lowercase characters and thus speeds up operations when a
 347         file cannot be found.
 348
 349         Default: no
 350
 351 + setup directory
 352         Path to data used by provisioning script.
 353
 354         Default: Set at compile-time
 355
 356 + ncalrpc dir
 357         Directory to use for UNIX sockets used by the 'ncalrpc' DCE/RPC transport.
 358
 359         Default: Set at compile-time
 360
 361 + ntvfs handler
 362         Backend to the NT VFS to use (more than one can be specified). Available
 363         backends include:
 364
 365         - posix:
 366                 Maps POSIX FS semantics to NT semantics
 367
 368         - simple:
 369                 Very simple backend (original testing backend).
 370
 371         - unixuid:
 372                 Sets up user credentials based on POSIX gid/uid.
 373
 374         - cifs:
 375                 Proxies a remote CIFS FS. Mainly useful for testing.
 376
 377         - nbench:
 378                 Filter module that saves data useful to the nbench benchmark suite.
 379
 380         - ipc:
 381                 Allows using SMB for inter process communication. Only used for
 382                 the IPC$ share.
 383
 384         - print:
 385                 Allows printing over SMB. This is LANMAN-style printing (?), not
 386                 the be confused with the spoolss DCE/RPC interface used by later
 387                 versions of Windows.
 388
 389         Default: unixuid default
 390
 391 + ntptr providor
 392         FIXME
 393
 394 + dcerpc endpoint servers
 395         What DCE/RPC servers to start.
 396
 397         Default: epmapper srvsvc wkssvc rpcecho samr netlogon lsarpc spoolss drsuapi winreg dssetup
 398
 399 + server services
 400         Services Samba should provide.
 401
 402         Default: smb rpc nbt wrepl ldap cldap web kdc
 403
 404 + sam database
 405         Location of the SAM (account database) database. This should be a
 406         LDB URL.
 407
 408         Default: set at compile-time
 409
 410 + spoolss database
 411         Spoolss (printer) DCE/RPC server database. This should be a LDB URL.
 412
 413         Default: set at compile-time
 414
 415 + wins config database
 416         WINS configuration database location. This should be a LDB URL.
 417
 418         Default: set at compile-time
 419
 420 + wins database
 421         WINS database location. This should be a LDB URL.
 422
 423         Default: set at compile-time
 424
 425 + client use spnego principal
 426         Tells the client to use the Kerberos service principal specified by the
 427         server during the security protocol negotation rather than
 428         looking up the principal itself (cifs/hostname).
 429
 430         Default: false
 431
 432 + nbt port
 433         TCP/IP Port used by the NetBIOS over TCP/IP (NBT) implementation.
 434
 435         Default: 137
 436
 437 + dgram port
 438         UDP/IP port used by the NetBIOS over TCP/IP (NBT) implementation.
 439
 440         Default: 138
 441
 442 + cldap port
 443         UDP/IP port used by the CLDAP protocol.
 444
 445         Default: 389
 446
 447 + krb5 port
 448         IP port used by the kerberos KDC.
 449
 450         Default: 88
 451
 452 + kpasswd port
 453         IP port used by the kerberos password change protocol.
 454
 455         Default: 464
 456
 457 + web port
 458         TCP/IP port SWAT should listen on.
 459
 460         Default: 901
 461
 462 + tls enabled
 463         Enable TLS support for SWAT
 464
 465         Default: true
 466
 467 + tls keyfile
 468         Path to TLS key file (PEM format) to be used by SWAT. If no
 469         path is specified, Samba will create a key.
 470
 471         Default: none
 472
 473 + tls certfile
 474         Path to TLS certificate file (PEM format) to be used by SWAT. If no
 475         path is specified, Samba will create a certificate.
 476
 477         Default: none
 478
 479 + tls cafile
 480         Path to CA authority file Samba will use to sign TLS keys it generates. If
 481         no path is specified, Samba will create a self-signed CA certificate.
 482
 483         Default: none
 484
 485 + tls crlfile
 486         Path to TLS certificate revocation lists file.
 487
 488         Default: none
 489
 490 + swat directory
 491         SWAT data directory.
 492
 493         Default: set at compile-time
 494
 495 + large readwrite
 496         Indicate the CIFS server is able to do large reads/writes.
 497
 498         Default: true
 499
 500 + unicode
 501         Enable/disable unicode support in the protocol.
 502
 503         Default: true