Samba3 Developers Guide

• Contents
• Part I The protocol
  • Chapter 1 NetBIOS in a Unix World
    • 1.1 Introduction
    • 1.2 Usernames
    • 1.3 File Ownership
    • 1.4 Passwords
    • 1.5 Locking
    • 1.6 Deny Modes
    • 1.7 Trapdoor UIDs
    • 1.8 Port numbers
    • 1.9 Protocol Complexity
  • Chapter 2 NT Domain RPC's
    • 2.1 Introduction
      • 2.1.1 Sources
      • 2.1.2 Credits
    • 2.2 Notes and Structures
      • 2.2.1 Notes
      • 2.2.2 Enumerations
        • 2.2.2.1 MSRPC Header type
        • 2.2.2.2 MSRPC Packet info
      • 2.2.3 Structures
        • 2.2.3.1 VOID *
        • 2.2.3.2 char
        • 2.2.3.3 UTIME
        • 2.2.3.4 NTTIME
        • 2.2.3.5 DOM_SID (domain SID structure)
        • 2.2.3.6 STR (string)
        • 2.2.3.7 UNIHDR (unicode string header)
        • 2.2.3.8 UNIHDR2 (unicode string header plus buffer pointer)
        • 2.2.3.9 UNISTR (unicode string)
        • 2.2.3.10 NAME (length-indicated unicode string)
        • 2.2.3.11 UNISTR2 (aligned unicode string)
        • 2.2.3.12 OBJ_ATTR (object attributes)
        • 2.2.3.13 POL_HND (LSA policy handle)
        • 2.2.3.14 DOM_SID2 (domain SID structure, SIDS stored in unicode)
        • 2.2.3.15 DOM_RID (domain RID structure)
        • 2.2.3.16 LOG_INFO (server, account, client structure)
        • 2.2.3.17 CLNT_SRV (server, client names structure)
        • 2.2.3.18 CREDS (credentials + time stamp)
        • 2.2.3.19 CLNT_INFO2 (server, client structure, client credentials)
        • 2.2.3.20 CLNT_INFO (server, account, client structure, client credentials)
        • 2.2.3.21 ID_INFO_1 (id info structure, auth level 1)
        • 2.2.3.22 SAM_INFO (sam logon/logoff id info structure)
        • 2.2.3.23 GID (group id info)
        • 2.2.3.24 DOM_REF (domain reference info)
        • 2.2.3.25 DOM_INFO (domain info, levels 3 and 5 are the same))
        • 2.2.3.26 USER_INFO (user logon info)
        • 2.2.3.27 SH_INFO_1_PTR (pointers to level 1 share info strings)
        • 2.2.3.28 SH_INFO_1_STR (level 1 share info strings)
        • 2.2.3.29 SHARE_INFO_1_CTR
        • 2.2.3.30 SERVER_INFO_101
    • 2.3 MSRPC over Transact Named Pipe
      • 2.3.1 MSRPC Pipes
      • 2.3.2 Header
        • 2.3.2.1 RPC_Packet for request, response, bind and bind acknowledgement
        • 2.3.2.2 Interface identification
        • 2.3.2.3 RPC_Iface RW
        • 2.3.2.4 RPC_ReqBind RW
        • 2.3.2.5 RPC_Address RW
        • 2.3.2.6 RPC_ResBind RW
        • 2.3.2.7 RPC_ReqNorm RW
        • 2.3.2.8 RPC_ResNorm RW
      • 2.3.3 Tail
      • 2.3.4 RPC Bind / Bind Ack
      • 2.3.5 NTLSA Transact Named Pipe
      • 2.3.6 LSA Open Policy
        • 2.3.6.1 Request
        • 2.3.6.2 Response
      • 2.3.7 LSA Query Info Policy
        • 2.3.7.1 Request
        • 2.3.7.2 Response
      • 2.3.8 LSA Enumerate Trusted Domains
        • 2.3.8.1 Request
        • 2.3.8.2 Response
      • 2.3.9 LSA Open Secret
        • 2.3.9.1 Request
        • 2.3.9.2 Response
      • 2.3.10 LSA Close
        • 2.3.10.1 Request
        • 2.3.10.2 Response
      • 2.3.11 LSA Lookup SIDS
        • 2.3.11.1 Request
        • 2.3.11.2 Response
      • 2.3.12 LSA Lookup Names
        • 2.3.12.1 Request
        • 2.3.12.2 Response
    • 2.4 NETLOGON rpc Transact Named Pipe
      • 2.4.1 LSA Request Challenge
        • 2.4.1.1 Request
        • 2.4.1.2 Response
      • 2.4.2 LSA Authenticate 2
        • 2.4.2.1 Request
        • 2.4.2.2 Response
      • 2.4.3 LSA Server Password Set
        • 2.4.3.1 Request
        • 2.4.3.2 Response
      • 2.4.4 LSA SAM Logon
        • 2.4.4.1 Request
        • 2.4.4.2 Response
      • 2.4.5 LSA SAM Logoff
        • 2.4.5.1 Request
        • 2.4.5.2 Response
    • 2.5 \\MAILSLOT\NET\NTLOGON
      • 2.5.1 Query for PDC
        • 2.5.1.1 Request
        • 2.5.1.2 Response
      • 2.5.2 SAM Logon
        • 2.5.2.1 Request
        • 2.5.2.2 Response
    • 2.6 SRVSVC Transact Named Pipe
      • 2.6.1 Net Share Enum
        • 2.6.1.1 Request
        • 2.6.1.2 Response
      • 2.6.2 Net Server Get Info
        • 2.6.2.1 Request
        • 2.6.2.2 Response
    • 2.7 Cryptographic side of NT Domain Authentication
      • 2.7.1 Definitions
      • 2.7.2 Protocol
      • 2.7.3 Comments
    • 2.8 SIDs and RIDs
      • 2.8.1 Well-known SIDs
        • 2.8.1.1 Universal well-known SIDs
        • 2.8.1.2 NT well-known SIDs
      • 2.8.2 Well-known RIDS
        • 2.8.2.1 Well-known RID users
        • 2.8.2.2 Well-known RID groups
        • 2.8.2.3 Well-known RID aliases
• Part II Samba Basics
  • Chapter 3 Samba Architecture
    • 3.1 Introduction
    • 3.2 Multithreading and Samba
    • 3.3 Threading smbd
    • 3.4 Threading nmbd
    • 3.5 nbmd Design
  • Chapter 4 The samba DEBUG system
    • 4.1 New Output Syntax
    • 4.2 The DEBUG() Macro
    • 4.3 The DEBUGADD() Macro
    • 4.4 The DEBUGLVL() Macro
    • 4.5 New Functions
      • 4.5.1 dbgtext()
      • 4.5.2 dbghdr()
      • 4.5.3 format_debug_text()
  • Chapter 5 Samba Internals
    • 5.1 Character Handling
    • 5.2 The new functions
    • 5.3 Macros in byteorder.h
      • 5.3.1 CVAL(buf,pos)
      • 5.3.2 PVAL(buf,pos)
      • 5.3.3 SCVAL(buf,pos,val)
      • 5.3.4 SVAL(buf,pos)
      • 5.3.5 IVAL(buf,pos)
      • 5.3.6 SVALS(buf,pos)
      • 5.3.7 IVALS(buf,pos)
      • 5.3.8 SSVAL(buf,pos,val)
      • 5.3.9 SIVAL(buf,pos,val)
      • 5.3.10 SSVALS(buf,pos,val)
      • 5.3.11 SIVALS(buf,pos,val)
      • 5.3.12 RSVAL(buf,pos)
      • 5.3.13 RIVAL(buf,pos)
      • 5.3.14 RSSVAL(buf,pos,val)
      • 5.3.15 RSIVAL(buf,pos,val)
    • 5.4 LAN Manager Samba API
      • 5.4.1 Parameters
      • 5.4.2 Return value
    • 5.5 Code character table
  • Chapter 6 Coding Suggestions
  • Chapter 7 Contributing code
  • Chapter 8 Modules
    • 8.1 Advantages
    • 8.2 Loading modules
      • 8.2.1 Static modules
      • 8.2.2 Shared modules
    • 8.3 Writing modules
      • 8.3.1 Static/Shared selection in configure.in
• Part III Samba Subsystems
  • Chapter 9 RPC Pluggable Modules
    • 9.1 About
    • 9.2 General Overview
  • Chapter 10 VFS Modules
    • 10.1 The Samba (Posix) VFS layer
      • 10.1.1 The general interface
      • 10.1.2 Possible VFS operation layers
    • 10.2 The Interaction between the Samba VFS subsystem and the modules
      • 10.2.1 Initialization and registration
      • 10.2.2 How the Modules handle per connection data
    • 10.3 Upgrading to the New VFS Interface
      • 10.3.1 Upgrading from 2.2.* and 3.0aplha modules
    • 10.4 Some Notes
      • 10.4.1 Implement TRANSPARENT functions
      • 10.4.2 Implement OPAQUE functions
  • Chapter 11 The smb.conf file
    • 11.1 Lexical Analysis
      • 11.1.1 Handling of Whitespace
      • 11.1.2 Handling of Line Continuation
      • 11.1.3 Line Continuation Quirks
    • 11.2 Syntax
      • 11.2.1 About params.c
  • Chapter 12 Samba WINS Internals
    • 12.1 WINS Failover
  • Chapter 13 LanMan and NT Password Encryption
    • 13.1 Introduction
    • 13.2 How does it work?
    • 13.3 The smbpasswd file
• Part IV Debugging and tracing
  • Chapter 14 Tracing samba system calls
  • Chapter 15 Samba Printing Internals
    • 15.1 Abstract
    • 15.2 Printing Interface to Various Back ends
    • 15.3 Print Queue TDB's
    • 15.4 ChangeID and Client Caching of Printer Information
    • 15.5 Windows NT/2K Printer Change Notify
• Part V Appendices
  • Chapter 16 Notes to packagers
    • 16.1 Versioning
    • 16.2 Modules