smb.conf/examples/2010-05-25

from HTYP, the free directory anyone can edit if they can prove to me that they're not a spambot
Jump to navigation Jump to search

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

<ini>

  1. ======================= Global Settings =======================

[global] log file = /var/log/samba/log.%m lanman auth = Yes

load printers = 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

follow symlinks = yes

passwd program = /usr/bin/passwd %u unix extensions = no dns proxy = no

printing = cups

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

os level = 20

client lanman auth = Yes comment = the Brother laserjet thingy printcap name = cups security = share syslog = 0

preferred master = no

usershare allow guests = yes panic action = /usr/share/samba/panic-action %d max log size = 1000 pam password change = yes

  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 <<kahan@informatik.tu-muenchen.de> 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. 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

  1. Windows clients look for this share name as a source of downloadable
  2. printer drivers

[print$] comment = Printer Drivers path = /var/lib/samba/printers

browseable = yes

guest ok = yes writeable = 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 </ini>