0d2c6234c70c28cd5b15fee1c35ae08bf4327455
[kai/samba.git] / 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 users 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