examples/smb.conf.default

   1 ;; This is the main Samba configuration file. You should read the
   2 ;; smb.conf(5) manual page in order to understand the options listed
   3 ;; here. Samba has a huge number of configurable options (perhaps too
   4 ;; many!) most of which are not shown in this example
   5
   6 ;; Any line which starts with a ; (semi-colon) is a comment and
   7 ;; is ignored
   8
   9 ;; Whenever you modify this file you should run the command "testparm"
  10 ;; to check that you have not many any basic syntactic errors.
  11
  12 ;;======================= Global Settings =====================================
  13 [global]
  14
  15 ;; workgroup = NT-Domain-Name or Workgroup-Name, eg: REDHAT4
  16    workgroup = MYGROUP
  17
  18 ;; server string is the equivalent of the NT Description field
  19    server string = Samba Server
  20
  21 ;; This option is important for security. It allows you to restrict
  22 ;; connections to machines which are on your local network. The
  23 ;; following example restricts access to two C class networks and
  24 ;; the "loopback" interface. For more examples of the syntax see
  25 ;; the smb.conf man page
  26 ;   hosts allow = 192.168.1. 192.168.2. 127.
  27
  28 ;; if you want to automatically load your printer list rather
  29 ;; than setting them up individually then you'll need this
  30    printcap name = /etc/printcap
  31    load printers = yes
  32
  33 ;; Uncomment this if you want a guest account, you must add this to /etc/passwd
  34 ;; otherwise the user "nobody" is used
  35 ;  guest account = pcguest
  36
  37 ;; this tells Samba to use a separate log file for each machine
  38 ;; that connects
  39    log file = /usr/local/samba/var/log.%m
  40
  41 ;; Put a capping on the size of the log files (in Kb).
  42    max log size = 50
  43
  44 ;; Security mode. Most people will want user level security. See
  45 ;; security_level.txt for details.
  46    security = user
  47 ;; Use password server option only with security = server
  48 ;   password server = <NT-Server-Name>
  49
  50 ;; Using the following line enables you to customise your configuration
  51 ;; on a per machine basis. The %m gets replaced with the netbios name
  52 ;; of the machine that is connecting
  53 ;   include = /usr/local/samba/lib/smb.conf.%m
  54
  55 ;; Most people will find that this option gives better performance.
  56 ;; See speed.txt and the manual pages for details
  57    socket options = TCP_NODELAY
  58
  59 ;; Configure Samba to use multiple interfaces
  60 ;; If you have multiple network interfaces then you must list them
  61 ;; here. See the man page for details.
  62 ;   interfaces = 192.168.12.2/24 192.168.13.2/24
  63
  64 ;; Browser Control Options:
  65 ;; set local master to no if you don't want Samba to become a master
  66 ;; browser on your network. Otherwise the normal election rules apply
  67 ;   local master = no
  68
  69 ;; OS Level determines the precedence of this server in master browser
  70 ;; elections. The default value should be reasonable
  71 ;   os level = 33
  72
  73 ;; Domain Master specifies Samba to be the Domain Master Browser. This
  74 ;; allows Samba to collate browse lists between subnets. Don't use this
  75 ;; if you already have a Windows NT domain controller doing this job
  76 ;   domain master = yes
  77
  78 ;; Preferred Master causes Samba to force a local browser election on startup
  79 ;; and gives it a slightly higher chance of winning the election
  80 ;   preferred master = yes
  81
  82 ;; Use only if you have an NT server on your network that has been
  83 ;; configured at install time to be a primary domain controller.
  84 ;   domain controller = <NT-Domain-Controller-SMBName>
  85
  86 ;; Enable this if you want Samba to be a domain logon server for
  87 ;; Windows95 workstations.
  88 ;   domain logons = yes
  89
  90 ;; if you enable domain logons then you may want a per-machine or
  91 ;; per user logon script
  92 ;; run a specific logon batch file per workstation (machine)
  93 ;   logon script = %m.bat
  94 ;; run a specific logon batch file per username
  95 ;   logon script = %u.bat
  96
  97 ;; Where to store roving profiles (only for Win95 and WinNT)
  98 ;;        %L substitutes for this servers netbios name, %U is username
  99 ;;        You must uncomment the [Profiles] share below
 100 ;   logon path = \\%L\Profiles\%U
 101
 102 ;; Windows Internet Name Serving Support Section:
 103 ;; WINS Support - Tells the NMBD component of Samba to enable it's WINS Server
 104 ;   wins support = yes
 105
 106 ;; WINS Server - Tells the NMBD components of Samba to be a WINS Client
 107 ;;      Note: Samba can be either a WINS Server, or a WINS Client, but NOT both
 108 ;   wins server = w.x.y.z
 109
 110 ;; WINS Proxy - Tells Samba to answer name resolution queries on
 111 ;; behalf of a non WINS capable client, for this to work there must be
 112 ;; at least one WINS Server on the network. The default is NO.
 113 ;   wins proxy = yes
 114
 115 ;;============================ Share Definitions ==============================
 116 [homes]
 117    comment = Home Directories
 118    browseable = no
 119    writable = yes
 120
 121 ;; Un-comment the following and create the netlogon directory for Domain Logons
 122 ; [netlogon]
 123 ;   comment = Network Logon Service
 124 ;   path = /usr/local/samba/lib/netlogon
 125 ;   guest ok = yes
 126 ;   writable = no
 127
 128
 129 ;; Un-comment the following to provide a specific roving profile share
 130 ;; the default is to use the user's home directory
 131 ;[Profiles]
 132 ;    path = /usr/local/samba/profiles
 133 ;    browseable = no
 134 ;    guest ok = yes
 135
 136
 137 ;; NOTE: If you have a BSD-style print system there is no need to
 138 ;; specifically define each individual printer
 139 [printers]
 140    comment = All Printers
 141    path = /usr/spool/samba
 142    browseable = no
 143 ;; Set public = yes to allow user 'guest account' to print
 144    guest ok = no
 145    writable = no
 146    printable = yes
 147
 148 ;; This one is useful for people to share files
 149 ;[tmp]
 150 ;   comment = Temporary file space
 151 ;   path = /tmp
 152 ;   read only = no
 153 ;   public = yes
 154
 155 ;; A publicly accessible directory, but read only, except for people in
 156 ;; the staff group
 157 ;[public]
 158 ;   comment = Public Stuff
 159 ;   path = /home/samba
 160 ;   public = yes
 161 ;   writable = yes
 162 ;   printable = no
 163 ;   write list = @users
 164
 165 ;; Other examples.
 166 ;;
 167 ;; A private printer, usable only by fred. Spool data will be placed in fred's
 168 ;; home directory. Note that fred must have write access to the spool directory,
 169 ;; wherever it is.
 170 ;[fredsprn]
 171 ;   comment = Fred's Printer
 172 ;   valid users = fred
 173 ;   path = /homes/fred
 174 ;   printer = freds_printer
 175 ;   public = no
 176 ;   writable = no
 177 ;   printable = yes
 178 ;
 179 ;; A private directory, usable only by fred. Note that fred requires write
 180 ;; access to the directory.
 181 ;[fredsdir]
 182 ;   comment = Fred's Service
 183 ;   path = /usr/somewhere/private
 184 ;   valid users = fred
 185 ;   public = no
 186 ;   writable = yes
 187 ;   printable = no
 188 ;
 189 ;; a service which has a different directory for each machine that connects
 190 ;; this allows you to tailor configurations to incoming machines. You could
 191 ;; also use the %u option to tailor it by user name.
 192 ;; The %m gets replaced with the machine name that is connecting.
 193 ;[pchome]
 194 ;  comment = PC Directories
 195 ;  path = /usr/pc/%m
 196 ;  public = no
 197 ;  writable = yes
 198 ;
 199 ;
 200 ;; A publicly accessible directory, read/write to all users. Note that all files
 201 ;; created in the directory by users will be owned by the default user, so
 202 ;; any user with access can delete any other user's files. Obviously this
 203 ;; directory must be writable by the default user. Another user could of course
 204 ;; be specified, in which case all files would be owned by that user instead.
 205 ;[public]
 206 ;   path = /usr/somewhere/else/public
 207 ;   public = yes
 208 ;   only guest = yes
 209 ;   writable = yes
 210 ;   printable = no
 211 ;
 212 ;
 213 ;; The following two entries demonstrate how to share a directory so that two
 214 ;; users can place files there that will be owned by the specific users. In this
 215 ;; setup, the directory should be writable by both users and should have the
 216 ;; sticky bit set on it to prevent abuse. Obviously this could be extended to
 217 ;; as many users as required.
 218 ;[myshare]
 219 ;   comment = Mary's and Fred's stuff
 220 ;   path = /usr/somewhere/shared
 221 ;   valid users = mary fred
 222 ;   public = no
 223 ;   writable = yes
 224 ;   printable = no
 225 ;   create mask = 0765
 226
 227