smb.conf/examples/2010-05-25

Working example from gonzo, just after I ran the Samba config utility (gksu system-config-samba) and closed it without changing anything. It apparently did the following:
 * uncommented "printer=laser"
 * commented out several settings near the beginning:
 * load printers = yes
 * follow symlinks = yes
 * printing = cups
 * os level = 20
 * preferred master = no
 * removed a couple of lines that were commented out already
 * in [print$], changed "read only = yes" to "writeable = yes"

After that, the "laser" printer share started working again after inexplicably stopping.

Contents

 * 1) ======================= Global Settings =======================

[global] log file = /var/log/samba/log.%m lanman auth = Yes guest account = sambaguest printer = laser passwd chat = *Enter\snew\s*\spassword:* %n\n *Retype\snew\s*\spassword:* %n\n *password\supdated\ssuccessfully*. obey pam restrictions = yes guest ok = yes map to guest = bad user domain master = no	passwd program = /usr/bin/passwd %u unix extensions = no	dns proxy = no	wide links = yes server string = %h server (Samba, Ubuntu) message command = /bin/sh -c '/usr/bin/linpopup unix password sync = yes local master = no	workgroup = pinecrest client lanman auth = Yes comment = the Brother laserjet thingy printcap name = cups security = share syslog = 0 usershare allow guests = yes panic action = /usr/share/samba/panic-action %d max log size = 1000 pam password change = yes
 * load printers = yes
 * follow symlinks = yes
 * printing = cups
 * os level = 20
 * preferred master = no
 * 1) allows samba to show/include symbolic-linked folders and files:
 * 2) allows links to targets not within the shared folder
 * 3) 2010-04-20 makes wide links work again


 * 1) added 2009-11-03 - apparently helpful for Win9x clients


 * 1) Browsing/Identification ###


 * 1) Change this to the workgroup/NT-domain name your Samba server will part of


 * 1) server string is the equivalent of the NT Description field


 * 1) Windows Internet Name Serving Support Section:
 * 2) WINS Support - Tells the NMBD component of Samba to enable its WINS Server
 * 3)   wins support = no


 * 1) WINS Server - Tells the NMBD components of Samba to be a WINS Client
 * 2) Note: Samba can be either a WINS Server, or a WINS Client, but NOT both
 * wins server = w.x.y.z


 * 1) This will prevent nmbd to search for NetBIOS names through DNS.


 * 1) What naming service and in what order should we use to resolve host names
 * 2) to IP addresses
 * name resolve order = lmhosts host wins bcast


 * 1) Networking ####


 * 1) The specific set of interfaces / networks to bind to
 * 2) This can be either the interface name or an IP address/netmask;
 * 3) interface names are normally preferred
 * interfaces = 127.0.0.0/8 eth0


 * 1) Only bind to the named interfaces and/or networks; you must use the
 * 2) 'interfaces' option above to use this.
 * 3) It is recommended that you enable this feature if your Samba machine is
 * 4) not protected by a firewall or is a firewall itself.  However, this
 * 5) option cannot handle dynamic or non-broadcast interfaces correctly.
 * bind interfaces only = yes


 * 1) Debugging/Accounting ####


 * 1) This tells Samba to use a separate log file for each machine
 * 2) that connects


 * 1) Cap the size of the individual log files (in KiB).


 * 1) If you want Samba to only log through syslog then set the following
 * 2) parameter to 'yes'.
 * 3)   syslog only = no


 * 1) We want Samba to log a minimum amount of information to syslog. Everything
 * 2) should go to /var/log/samba/log.{smbd,nmbd} instead. If you want to log
 * 3) through syslog you should set the following parameter to something higher.


 * 1) Do something sensible when Samba crashes: mail the admin a backtrace


 * 1) Authentication #######


 * 1) "security = user" is always a good idea. This will require a Unix account
 * 2) in this server for every user accessing the server. See
 * 3) /usr/share/doc/samba-doc/htmldocs/Samba3-HOWTO/ServerType.html
 * 4) in the samba-doc package for details.
 * 5)   security = user


 * 1) You may wish to use password encryption.  See the section on
 * 2) 'encrypt passwords' in the smb.conf(5) manpage before enabling.
 * encrypt passwords = yes


 * 1) If you are using encrypted passwords, Samba will need to know what
 * 2) password database type you are using.
 * passdb backend = tdbsam


 * 1) This boolean parameter controls whether Samba attempts to sync the Unix
 * 2) password with the SMB password when the encrypted SMB password in the
 * 3) passdb is changed.


 * 1) For Unix password sync to work on a Debian GNU/Linux system, the following
 * 2) parameters must be set (thanks to Ian Kahan < for
 * 3) sending the correct chat script for the passwd program in Debian Sarge).


 * 1) This boolean controls whether PAM will be used for password changes
 * 2) when requested by an SMB client instead of the program listed in
 * 3) 'passwd program'. The default is 'no'.


 * 1) This option controls how unsuccessful authentication attempts are mapped
 * 2) to anonymous connections


 * 1) Domains ###########


 * 1) Is this machine able to authenticate users. Both PDC and BDC
 * 2) must have this setting enabled. If you are the BDC you must
 * 3) change the 'domain master' setting to no
 * domain logons = yes
 * 1) The following setting only takes effect if 'domain logons' is set
 * 2) It specifies the location of the user's profile directory
 * 3) from the client point of view)
 * 4) The following required a [profiles] share to be setup on the
 * 5) samba server (see below)
 * logon path = \\%N\profiles\%U
 * 1) Another common choice is storing the profile in the user's home directory
 * 2) (this is Samba's default)
 * 3)   logon path = \\%N\%U\profile
 * 1) (this is Samba's default)
 * 2)   logon path = \\%N\%U\profile


 * 1) The following setting only takes effect if 'domain logons' is set
 * 2) It specifies the location of a user's home directory (from the client
 * 3) point of view)
 * logon drive = H:
 * 1)   logon home = \\%N\%U


 * 1) The following setting only takes effect if 'domain logons' is set
 * 2) It specifies the script to run during logon. The script must be stored
 * 3) in the [netlogon] share
 * 4) NOTE: Must be store in 'DOS' file format convention
 * logon script = logon.cmd


 * 1) This allows Unix users to be created on the domain controller via the SAMR
 * 2) RPC pipe.  The example command creates a user account with a disabled Unix
 * 3) password; please adapt to your needs
 * add user script = /usr/sbin/adduser --quiet --disabled-password --gecos "" %u


 * 1) This allows machine accounts to be created on the domain controller via the
 * 2) SAMR RPC pipe.
 * 3) The following assumes a "machines" group exists on the system
 * add machine script = /usr/sbin/useradd -g machines -c "%u machine account" -d /var/lib/samba -s /bin/false %u


 * 1) This allows Unix groups to be created on the domain controller via the SAMR
 * 2) RPC pipe.
 * add group script = /usr/sbin/addgroup --force-badname %g


 * 1) Printing ##########


 * 1) If you want to automatically load your printer list rather
 * 2) than setting them up individually then you'll need this


 * 1) lpr(ng) printing. You may wish to override the location of the
 * 2) printcap file


 * 1) CUPS printing.  See also the cupsaddsmb(8) manpage in the
 * 2) cupsys-client package.


 * 1) Misc ############


 * 1) Using the following line enables you to customise your configuration
 * 2) on a per machine basis. The %m gets replaced with the netbios name
 * 3) of the machine that is connecting
 * include = /home/samba/etc/smb.conf.%m


 * 1) Most people will find that this option gives better performance.
 * 2) See smb.conf(5) and /usr/share/doc/samba-doc/htmldocs/Samba3-HOWTO/speed.html
 * 3) for details
 * 4) You may want to add the following on a Linux system:
 * 5)         SO_RCVBUF=8192 SO_SNDBUF=8192
 * 6)   socket options = TCP_NODELAY


 * 1) The following parameter is useful only if you have the linpopup package
 * 2) installed. The samba maintainer and the linpopup maintainer are
 * 3) working to ease installation and configuration of linpopup and samba.


 * 1) Domain Master specifies Samba to be the Domain Master Browser. If this
 * 2) machine will be configured as a BDC (a secondary logon server), you
 * 3) must set this to 'no'; otherwise, the default behavior is recommended.
 * 4)   domain master = auto


 * 1) Some defaults for winbind (make sure you're not using the ranges
 * 2) for something else.)
 * idmap uid = 10000-20000
 * idmap gid = 10000-20000
 * template shell = /bin/bash


 * 1) The following was the default behaviour in sarge,
 * 2) but samba upstream reverted the default because it might induce
 * 3) performance issues in large organizations.
 * 4) See Debian bug #368251 for some of the consequences of *not*
 * 5) having this setting and smb.conf(5) for details.
 * winbind enum groups = yes
 * winbind enum users = yes


 * 1) Setup usershare options to enable non-root users to share folders
 * 2) with the net usershare command.


 * 1) Maximum number of usershare. 0 (default) means that usershare is disabled.
 * usershare max shares = 100


 * 1) Allow users who've been granted usershare privileges to create
 * 2) public shares, not just authenticated ones


 * 1) ======================= Share Definitions =======================


 * 1) Un-comment the following (and tweak the other settings below to suit)
 * 2) to enable the default home directory shares.  This will share each
 * 3) user's home directory as \\server\username
 * [homes]
 * comment = Home Directories
 * browseable = no


 * 1) By default, the home directories are exported read-only. Change the
 * 2) next parameter to 'no' if you want to be able to write to them.
 * read only = yes


 * 1) File creation mask is set to 0700 for security reasons. If you want to
 * 2) create files with group=rw permissions, set next parameter to 0775.
 * create mask = 0700


 * 1) Directory creation mask is set to 0700 for security reasons. If you want to
 * 2) create dirs. with group=rw permissions, set next parameter to 0775.
 * directory mask = 0700


 * 1) By default, \\server\username shares can be connected to by anyone
 * 2) with access to the samba server.  Un-comment the following parameter
 * 3) to make sure that only "username" can connect to \\server\username
 * 4) This might need tweaking when using external authentication schemes
 * valid users = %S


 * 1) Un-comment the following and create the netlogon directory for Domain Logons
 * 2) (you need to configure Samba to act as a domain controller too.)
 * [netlogon]
 * comment = Network Logon Service
 * path = /home/samba/netlogon
 * guest ok = yes
 * read only = yes
 * share modes = no


 * 1) Un-comment the following and create the profiles directory to store
 * 2) users profiles (see the "logon path" option above)
 * 3) (you need to configure Samba to act as a domain controller too.)
 * 4) The path below should be writable by all users so that their
 * 5) profile directory may be created the first time they log on
 * [profiles]
 * comment = Users profiles
 * path = /home/samba/profiles
 * guest ok = no
 * browseable = no
 * create mask = 0600
 * directory mask = 0700

[printers] create mask = 0700 comment = All Printers printable = yes writable = yes public = yes path = /var/spool/samba

[print$] comment = Printer Drivers path = /var/lib/samba/printers guest ok = yes writeable = yes
 * 1) Windows clients look for this share name as a source of downloadable
 * 2) printer drivers
 * browseable = yes

[stuff] path = /home/woozle/Public/ guest ok = yes read only = no	map archive = no	force create mode = 0777 force security mode = 777 force directory security mode = 0777 force directory mode = 777

[things] path = /home/woozle/things/ guest ok = yes read only = no	force create mode = 777 force security mode = 777 force directory security mode = 777