1smb(4)                           File Formats                           smb(4)
2
3
4

NAME

6       smb - configuration properties for Solaris CIFS server
7

DESCRIPTION

9       Behavior  of the Solaris CIFS server is defined by property values that
10       are stored in the Service Management Facility, smf(5).
11
12
13       An authorized user can use the sharectl(1M) command to set global  val‐
14       ues for these properties in SMF.
15
16
17       The following list describes the properties:
18
19       ads_site
20
21           Specifies  the  site  configured in DNS to look up Active Directory
22           information. Sites provide a mechanism  to  partition  or  delegate
23           administration  and  policy management, which are typically used in
24           large or complex domains.
25
26           The value should not be set if you  do  not  have  a  local  Active
27           Directory site. By default, no value is set.
28
29
30       autohome_map
31
32           Specifies the full path for the SMD autohome map file, smbautohome.
33           The default path is /etc.
34
35
36       disposition
37
38           A value that controls whether to disconnect the share or proceed if
39           the  map  command  fails. The disposition property only has meaning
40           when the map property has been  set.  Otherwise  it  will  have  no
41           effect.
42
43             disposition = [ continue | terminate ]
44
45
46
47           continue
48
49               Proceed with share connection if the map command fails. This is
50               the default in the event that disposition is not specified.
51
52
53           terminate
54
55               Disconnect the share if the map command fails.
56
57
58
59       ddns_enable
60
61           Enables or disables dynamic DNS updates. A value  of  true  enables
62           dynamic  updates,  while a value of false disables dynamic updates.
63           By default, the value is false.
64
65
66       ipv6_enabled
67
68           Enables IPv6 Internet protocol support  within  the  CIFS  Service.
69           Valid values are true and false. The default value is false.
70
71
72       keep_alive
73
74           Specifies  the  number  of seconds before an idle SMB connection is
75           dropped by the Solaris CIFS server. If set to 0,  idle  connections
76           are  not dropped. Valid values are 0 and from 20 seconds and above.
77           The default value is 5400 seconds.
78
79
80       lmauth_level
81
82           Specifies the LAN Manager (LM) authentication level. The LM compat‐
83           ibility  level  controls  the type of user authentication to use in
84           workgroup mode or domain mode. The default value is 3.
85
86           The following describes the behavior at each level.
87
88           2            In Windows workgroup mode,  the  Solaris  CIFS  server
89                        accepts LM, NTLM, LMv2, and NTLMv2 requests. In domain
90                        mode, the SMB redirector on the  Solaris  CIFS  server
91                        sends NTLM requests.
92
93
94           3            In  Windows  workgroup  mode,  the Solaris CIFS server
95                        accepts LM, NTLM, LMv2, and NTLMv2 requests. In domain
96                        mode,  the  SMB  redirector on the Solaris CIFS server
97                        sends LMv2 and NTLMv2 requests.
98
99
100           4            In Windows workgroup mode,  the  Solaris  CIFS  server
101                        accepts  NTLM,  LMv2,  and  NTLMv2 requests. In domain
102                        mode, the SMB redirector on the  Solaris  CIFS  server
103                        sends LMv2 and NTLMv2 requests.
104
105
106           5            In  Windows  workgroup  mode,  the Solaris CIFS server
107                        accepts LMv2 and NTLMv2 requests. In domain mode,  the
108                        SMB  redirector  on the Solaris CIFS server sends LMv2
109                        and NTLMv2 requests.
110
111
112
113       map
114
115           The value is a command to be executed when connecting to the share.
116           The command can take the following arguments, which will be substi‐
117           tuted when the command is exec'd as described below:
118
119           %U
120
121               Windows username.
122
123
124           %D
125
126               Name of the domain or workgroup of %U.
127
128
129           %h
130
131               The server hostname.
132
133
134           %M
135
136               The client hostname, or "" if not available.
137
138
139           %L
140
141               The server NetBIOS name.
142
143
144           %m
145
146               The client NetBIOS name, or "" if not available. This option is
147               only valid for NetBIOS connections (port 139).
148
149
150           %I
151
152               The IP address of the client machine.
153
154
155           %i
156
157               The local IP address to which the client is connected.
158
159
160           %S
161
162               The name of the share.
163
164
165           %P
166
167               The root directory of the share.
168
169
170           %u
171
172               The UID of the Unix user.
173
174
175
176       max_workers
177
178           Specifies  the  maximum  number  of  worker  threads  that  will be
179           launched to process incoming CIFS requests. The SMB max_mpx  value,
180           which  indicates  to a client the maximum number of outstanding SMB
181           requests that it may have pending on the server,  is  derived  from
182           the  max_workers value. To ensure compatibility with older versions
183           of Windows the lower 8-bits of max_mpx must not  be  zero.  If  the
184           lower  byte  of max_workers is zero, 64 is added to the value. Thus
185           the minimum value is 64 and the default  value,  which  appears  in
186           sharectl(1M) as 1024, is 1088.
187
188
189       netbios_scope
190
191           Specifies  the  NetBIOS  scope identifier, which identifies logical
192           NetBIOS networks that are on the same physical  network.  When  you
193           specify  a  NetBIOS scope identifier, the server filters the number
194           of machines that are listed in the browser display to make it  eas‐
195           ier to find other hosts. The value is a text string that represents
196           a domain name. By default, no value is set.
197
198
199       pdc
200
201           Specifies the preferred IP address for the domain controller.  This
202           property  is  sometimes  used  when  there are multiple domain con‐
203           trollers to indicate which  one  is  preferred.  If  the  specified
204           domain  controller  responds, it is chosen even if the other domain
205           controllers are also available. By default, no value is set.
206
207
208       restrict_anonymous
209
210           Disables anonymous access to IPC$, which requires that  the  client
211           be  authenticated  to  get access to MSRPC services through IPC$. A
212           value of true disables anonymous access to IPC$, while a  value  of
213           false enables anonymous access.
214
215
216       signing_enabled
217
218           Enables SMB signing. When signing is enabled but not required it is
219           possible for clients to connect regardless of whether  or  not  the
220           client  supports SMB signing. If a packet has been signed, the sig‐
221           nature will be verified. If a packet has not been signed it will be
222           accepted  without signature verification. Valid values are true and
223           false. The default value is false.
224
225
226       signing_required
227
228           When SMB signing is required, all packets must be  signed  or  they
229           will  be  rejected, and clients that do not support signing will be
230           unable to connect to the server. The  signing_required  setting  is
231           only  taken into account when signing_enabled is true. Valid values
232           are true and false. The default value is false.
233
234
235       system_comment
236
237           Specifies an optional description for the system, which is  a  text
238           string. This property value might appear in various places, such as
239           Network Neighborhood or  Network  Places  on  Windows  clients.  By
240           default, no value is set.
241
242
243       unmap
244
245           The value is a command to be executed when disconnecting the share.
246           The command can take the same substitutions listed on the map prop‐
247           erty.
248
249
250       wins_exclude
251
252           Specifies  a comma-separated list of network interfaces that should
253           not be registered with WINS. NetBIOS host announcements are made on
254           excluded interfaces.
255
256
257       wins_server_1
258
259           Specifies the IP address of the primary WINS server. By default, no
260           value is set.
261
262
263       wins_server_2
264
265           Specifies the IP address of the secondary WINS server. By  default,
266           no value is set.
267
268

ATTRIBUTES

270       See  the  attributes(5)  man  page  for  descriptions  of the following
271       attributes:
272
273
274
275
276       ┌─────────────────────────────┬─────────────────────────────┐
277       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
278       ├─────────────────────────────┼─────────────────────────────┤
279       │Availability                 │SUNWsmbsu                    │
280       ├─────────────────────────────┼─────────────────────────────┤
281       │Interface Stability          │Uncommitted                  │
282       └─────────────────────────────┴─────────────────────────────┘
283

SEE ALSO

285       sharectl(1M), smbadm(1M), smbd(1M), smbstat(1M), attributes(5), smf(5)
286
287
288
289SunOS 5.11                        25 Sep 2009                           smb(4)
Impressum