This commit was generated by cvs2svn to compensate for changes in r4,
[samba.git] / examples / simple / smb.conf
1 ; Configuration file for smbd.
2 ; ============================================================================
3 ; For the format of this file and comprehensive descriptions of all the
4 ; configuration option, please refer to the man page for smb.conf(5).
5 ;
6 ; The following configuration should suit most systems for basic usage and 
7 ; initial testing. It gives all clients access to their home directories and
8 ; allows access to all printers specified in /etc/printcap.
9 ;
10 ; Things you need to check:
11 ; --------------------------
12 ;
13 ; 1: Check the path to your printcap file. If you are using a system that does 
14 ;    not use printcap (eg., Solaris), create a file containing lines of the 
15 ;    form
16 ;
17 ;       printername|printername|printername|
18 ;
19 ;    where each "printername" is the name of a printer you want to provide 
20 ;    access to. Then alter the "printcap =" entry to point to the new file.
21 ;
22 ;    If using Solaris, the following command will generate a suitable printcap
23 ;    file:
24 ;
25 ;       lpc status | grep ":" | sed s/:/\|/ > myprintcap
26 ;
27 ; 2: Make sure the "print command" entry is correct for your system. This 
28 ;    command should submit a file (represented by %s) to a printer 
29 ;    (represented by %p) for printing and should REMOVE the file after 
30 ;    printing.
31 ;  
32 ;    One most systems the default will be OK, as long as you get "printing ="
33 ;    right.
34 ;    
35 ;    It is also a good idea to use an absolute path in the print command
36 ;    as there is no guarantee the search path will be set correctly.
37 ;
38 ; 3: Make sure the "printing =" option is set correctly for your system.
39 ;    Possible values are "sysv", "bsd" or "aix".
40 ;
41 ; 4: Make sure the "lpq command" entry is correct for your system. The default
42 ;    may not work for you.
43 ;
44 ; 5: Make sure that the user specified in "guest account" exists. Typically
45 ;    this will be a user that cannot log in and has minimal privileges.
46 ;    Often the "nobody" account doesn't work (very system dependant).
47 ;
48 ; 6: You should consider the "security =" option. See a full description
49 ;    in the main documentation and the smb.conf(5) manual page
50 ;
51 ; 7: Look at the "hosts allow" option, unless you want everyone on the internet
52 ;    to be able to access your files.
53 ;
54 [global]
55    printing = bsd
56    printcap name = /etc/printcap
57    load printers = yes
58    guest account = pcguest
59 ;  This next option sets a separate log file for each client. Remove
60 ;  it if you want a combined log file.
61    log file = /usr/local/samba/log.%m
62
63 ;  You will need a world readable lock directory and "share modes=yes"
64 ;  if you want to support the file sharing modes for multiple users
65 ;  of the same files
66 ;  lock directory = /usr/local/samba/var/locks
67 ;  share modes = yes
68
69 [homes]
70    comment = Home Directories
71    browseable = no
72    read only = no
73    create mode = 0750
74
75 [printers]
76    comment = All Printers
77    browseable = no
78    printable = yes
79    public = no
80    writable = no
81    create mode = 0700
82
83 ; you might also want this one
84 ; [tmp]
85 ;   comment = Temporary file space
86 ;   path = /tmp
87 ;   read only = no
88 ;   public = yes
89
90 ;
91 ; Other examples. 
92 ;
93 ; A private printer, usable only by fred. Spool data will be placed in fred's
94 ; home directory. Note that fred must have write access to the spool directory,
95 ; wherever it is.
96 ;[fredsprn]
97 ;   comment = Fred's Printer
98 ;   valid users = fred
99 ;   path = /homes/fred
100 ;   printer = freds_printer
101 ;   public = no
102 ;   writable = no
103 ;   printable = yes
104 ;
105 ; A private directory, usable only by fred. Note that fred requires write
106 ; access to the directory.
107 ;[fredsdir]
108 ;   comment = Fred's Service
109 ;   path = /usr/somewhere/private
110 ;   valid users = fred
111 ;   public = no
112 ;   writable = yes
113 ;   printable = no
114 ;
115 ; A publicly accessible directory, but read only, except for people in
116 ; the staff group
117 ;[public]
118 ;   comment = Public Stuff
119 ;   path = /usr/somewhere/public
120 ;   public = yes
121 ;   writable = no
122 ;   printable = no
123 ;   write list = @staff
124 ;
125 ; a service which has a different directory for each machine that connects
126 ; this allows you to tailor configurations to incoming machines. You could
127 ; also use the %u option to tailor it by user name.
128 ; The %m gets replaced with the machine name that is connecting.
129 ;[pchome]
130 ;  comment = PC Directories
131 ;  path = /usr/pc/%m
132 ;  public = no
133 ;  writeable = yes
134 ;
135 ;
136 ; A publicly accessible directory, read/write to all users. Note that all files
137 ; created in the directory by users will be owned by the default user, so
138 ; any user with access can delete any other user's files. Obviously this
139 ; directory must be writable by the default user. Another user could of course
140 ; be specified, in which case all files would be owned by that user instead.
141 ;[public]
142 ;   path = /usr/somewhere/else/public
143 ;   public = yes
144 ;   only guest = yes
145 ;   writable = yes
146 ;   printable = no
147 ;
148 ;
149 ; The following two entries demonstrate how to share a directory so that two
150 ; users can place files there that will be owned by the specific users. In this
151 ; setup, the directory should be writable by both users and should have the
152 ; sticky bit set on it to prevent abuse. Obviously this could be extended to
153 ; as many users as required.
154 ;[myshare]
155 ;   comment = Mary's and Fred's stuff
156 ;   path = /usr/somewhere/shared
157 ;   valid users = mary fred
158 ;   public = no
159 ;   writable = yes
160 ;   printable = no
161 ;   create mask = 0765
162
163
164
165