Print this page
Convert mount_smbfs.1m to mdoc
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/mount_smbfs.1m.man.txt
+++ new/usr/src/man/man1m/mount_smbfs.1m.man.txt
1 1 MOUNT_SMBFS(1M) Maintenance Commands MOUNT_SMBFS(1M)
2 2
3 -
4 -
5 3 NAME
6 - mount_smbfs, umount_smbfs - mount and unmount a shared resource from a
7 - CIFS file server
4 + mount_smbfs, umount_smbfs - mount and unmount a shared resource from an
5 + SMB file server
8 6
9 7 SYNOPSIS
10 - /sbin/mount [-F smbfs] [generic-options] [-o name=value] [-O] resource
8 + mount [-F smbfs] [generic-options] [-o name[=value]] [-O] resource
9 + mount [-F smbfs] [generic-options] [-o name[=value]] [-O] mount-point
10 + mount [-F smbfs] [generic-options] [-o name[=value]] [-O]
11 + resource mount-point
12 + umount [-F smbfs] [generic-options] mount-point
11 13
12 -
13 - /sbin/mount [-F smbfs] [generic-options] [-o name=value] [-O] mount-point
14 -
15 -
16 - /sbin/mount [-F smbfs] [generic-options] [-o name=value]
17 - [-O] resource mount-point
18 -
19 -
20 - /sbin/umount [-F smbfs] [generic-options] mount-point
21 -
22 -
23 14 DESCRIPTION
24 - The mount utility attaches a named resource, resource, to the file
25 - system hierarchy at the path name location, mount-point, which must
26 - already exist.
15 + The mount utility attaches a named resource, resource, to the file system
16 + hierarchy at the path name location, mount-point, which must already
17 + exist.
27 18
19 + The mount utility attaches a named resource, resource, to the file system
20 + hierarchy at the path name location, mount-point, which must already
21 + exist.
28 22
29 - If mount-point has any contents prior to the mount operation, those
30 - contents remain hidden until the resource is unmounted. An authorized
31 - user with the SYS_MOUNT privilege can perform a mount operation. Also,
32 - a user can perform SMBFS mount operations on a directory the user owns.
23 + If mount-point has any contents prior to the mount operation, those
24 + contents remain hidden until the resource is unmounted. An authorized
25 + user with the SYS_MOUNT privilege can perform a mount operation. Also, a
26 + user can perform SMBFS mount operations on a directory the user owns.
33 27
28 + If the resource is listed in the /etc/vfstab file, you can specify either
29 + resource or mount-point as the mount command will consult the /etc/vfstab
30 + file for more information. If the -F option is omitted, mount takes the
31 + file system type from the entry in the /etc/vfstab file.
34 32
35 - If the resource is listed in the /etc/vfstab file, you can specify
36 - either resource or mount-point as the mount command will consult the
37 - /etc/vfstab file for more information. If the -F option is omitted,
38 - mount takes the file system type from the entry in the /etc/vfstab
39 - file.
33 + If the resource is not listed in the /etc/vfstab file, the command line
34 + must specify both resource and mount-point.
40 35
36 + The umount utility detaches a mounted file system from the file system
37 + hierarchy. An authorized user with the SYS_MOUNT privilege can perform a
38 + umount operation. Also, a user can perform SMBFS unmount operations on a
39 + directory the user owns.
41 40
42 - If the resource is not listed in the /etc/vfstab file, the command line
43 - must specify both resource and mount-point.
41 + The network/smb/client service must be enabled to successfully mount an
42 + SMB share. This service is enabled, by default.
44 43
44 + To enable the service, enter the following svcadm(1M) command:
45 45
46 - The umount utility detaches a mounted file system from the file system
47 - hierarchy. An authorized user with the SYS_MOUNT privilege can perform
48 - a umount operation. Also, a user can perform SMBFS unmount operations
49 - on a directory the user owns.
46 + # svcadm enable network/smb/client
50 47
51 -
52 - The network/smb/client service must be enabled to successfully mount a
53 - CIFS share. This service is enabled, by default.
54 -
55 -
56 - To enable the service, enter the following svcadm(1M) command:
57 -
58 - # svcadm enable network/smb/client
59 -
60 -
61 -
62 48 Operands
63 - The mount command supports the following operands:
49 + The mount command supports the following operands:
64 50
65 - resource //[workgroup;][user[:password]@]server/share
51 + resource //[workgroup;][user[:password]@]server/share
52 + The name of the resource to be mounted. In addition to its name,
53 + you can specify the following information about the resource:
66 54
55 + o password is the password associated with user. If password
56 + is not specified, the mount first attempts to use the
57 + password stored by the smbutil login command (if any). If
58 + that password fails to authenticate, the mount_smbfs prompts
59 + you for a password.
67 60
61 + o server is the DNS or NetBIOS name of the remote computer.
68 62
69 - The name of the resource to be mounted. In addition to its name,
70 - you can specify the following information about the resource:
63 + o share is the resource name on the remote server.
71 64
72 - o password is the password associated with user. If
73 - password is not specified, the mount first attempts to
74 - use the password stored by the smbutil login command (if
75 - any). If that password fails to authenticate, the
76 - mount_smbfs prompts you for a password.
65 + o user is the remote user name. If user is omitted, the logged
66 + in user ID is used.
77 67
78 - o server is the DNS or NetBIOS name of the remote
79 - computer.
68 + o workgroup is the name of the workgroup or the Windows domain
69 + in which the user name is defined.
80 70
81 - o share is the resource name on the remote server.
71 + If the resource includes a workgroup, you must escape the
72 + semicolon that appears after the workgroup name to prevent it
73 + from being interpreted by the command shell. For instance,
74 + surround the entire resource name with double quotes:
82 75
83 - o user is the remote user name. If user is omitted, the
84 - logged in user ID is used.
76 + mount -F smbfs "//SALES;george@RSERVER" /mnt
85 77
86 - o workgroup is the name of the workgroup or the Windows
87 - domain in which the user name is defined.
78 + mount-point
79 + The path to the location where the file system is to be mounted
80 + or unmounted. The mount command maintains a table of mounted
81 + file systems in the /etc/mnttab file. See the mnttab(4) man
82 + page.
88 83
89 - If the resource includes a workgroup, you must escape
90 - the semicolon that appears after the workgroup name to
91 - prevent it from being interpreted by the command shell.
92 - For instance, surround the entire resource name with
93 - double quotes: mount -F smbfs "//SALES;george@RSERVER"
94 - /mnt.
95 -
96 -
97 - mount-point
98 -
99 - The path to the location where the file system is to be mounted or
100 - unmounted. The mount command maintains a table of mounted file
101 - systems in the /etc/mnttab file. See the mnttab(4) man page.
102 -
103 -
104 84 OPTIONS
105 - See the mount(1M) man page for the list of supported generic-options.
85 + See the mount(1M) man page for the list of supported generic-options.
106 86
107 - -o name=value or
108 - -o name
87 + -o name[=value]
88 + Sets the file system-specific properties. You can specify more
89 + than one name-value pair as a list of comma-separated pairs. No
90 + spaces are permitted in the list. The properties are as follows:
109 91
110 - Sets the file system-specific properties. You can specify more than
111 - one name-value pair as a list of comma-separated pairs. No spaces
112 - are permitted in the list. The properties are as follows:
92 + acl|noacl
93 + Enable (or disable) presentation of Access Control Lists
94 + (ACLs) on files and directories under this smbfs(7FS)
95 + mount. The default behavior is noacl, which presents
96 + files and directories as owned by the owner of the mount
97 + point and having permissions based on fileperms or
98 + dirperms. With the acl mount option, files are presented
99 + with ACLs obtained from the SMB server. Setting the acl
100 + mount option is not advised unless the system is joined
101 + to an Active Directory domain and using ldap(1) so it can
102 + correctly present ACL identities from the SMB server.
113 103
104 + dirperms=octaltriplet
105 + Specifies the permissions to be assigned to directories.
106 + The value must be specified as an octal triplet, such as
107 + `755'. The default value for the directory mode is taken
108 + from the fileperms setting, with execute permission added
109 + where fileperms has read permission.
114 110
115 - acl|noacl
111 + Note that these permissions have no relation to the
112 + rights granted by the SMB server.
116 113
117 - Enable (or disable) presentation of Access Control Lists (ACLs)
118 - on files and directories under this smbfs(7FS) mount. The
119 - default behavior is noacl, which presents files and directories
120 - as owned by the owner of the mount point and having permissions
121 - based on fileperms or dirperms. With the acl mount option,
122 - files are presented with ACLs obtained from the SMB server.
123 - Setting the acl mount option is not advised unless the system
124 - is joined to an Active Directory domain and using ldap(1) so it
125 - can correctly present ACL identities from the SMB server.
114 + fileperms=octaltriplet
115 + Specifies the permissions to be assigned to files. The
116 + value must be specified as an octal triplet, such as
117 + `644'. The default value is `700'.
126 118
119 + Note that these permissions have no relation to the
120 + rights granted by the SMB server.
127 121
128 - dirperms=octaltriplet
122 + gid=groupid
123 + Assigns the specified group ID to files. The default
124 + value is the group ID of the directory where the volume
125 + is mounted.
129 126
130 - Specifies the permissions to be assigned to directories. The
131 - value must be specified as an octal triplet, such as 755. The
132 - default value for the directory mode is taken from the
133 - fileperms setting, with execute permission added where
134 - fileperms has read permission.
127 + intr|nointr
128 + Enable (or disable) cancellation of smbfs(7FS) I/O
129 + operations when the user interrupts the calling thread
130 + (for example, by hitting Ctrl-C while an operation is
131 + underway). The default is intr (interruption enabled),
132 + so cancellation is normally allowed.
135 133
136 - Note that these permissions have no relation to the rights
137 - granted by the CIFS server.
134 + noprompt
135 + Suppresses the prompting for a password when mounting a
136 + share. This property enables you to permit anonymous
137 + access to a share. Anonymous access does not require a
138 + password.
138 139
140 + The mount operation fails if a password is required, the
141 + noprompt property is set, and no password is stored by
142 + the smbutil login command.
139 143
140 - fileperms=octaltriplet
144 + retry_count=number
145 + Specifies the number of SMBFS retries to attempt before
146 + the connection is marked as broken. By default, 4
147 + attempts are made.
141 148
142 - Specifies the permissions to be assigned to files. The value
143 - must be specified as an octal triplet, such as 644. The default
144 - value is 700.
149 + The retry_count property value set by the mount command
150 + overrides the global value set in SMF or the value set in
151 + your .nsmbrc file.
145 152
146 - Note that these permissions have no relation to the rights
147 - granted by the CIFS server.
153 + timeout=seconds
154 + Specifies the SMB request timeout. By default, the
155 + timeout is 15 seconds.
148 156
157 + The timeout property value set by the mount command
158 + overrides the global value set in SMF or the value set in
159 + your .nsmbrc file.
149 160
150 - gid=groupid
161 + uid=userid
162 + Assigns the specified user ID files. The default value
163 + is the owner ID of the directory where the volume is
164 + mounted.
151 165
152 - Assigns the specified group ID to files. The default value is
153 - the group ID of the directory where the volume is mounted.
166 + xattr|noxattr
167 + Enable (or disable) Extended Attributes in this mount
168 + point. This option defaults to xattr (enabled Extended
169 + Attributes), but note: if the SMB server does not support
170 + SMB "named streams", smbfs(7FS) forces this option to
171 + noxattr. When a mount has the noxattr option, attempts
172 + to use Extended attributes fail with EINVAL.
154 173
174 + -O Overlays mount. Allow the file system to be mounted over an
175 + existing mount point, making the underlying file system
176 + inaccessible. If a mount is attempted on a pre-existing mount
177 + point without setting this flag, the mount fails, producing the
178 + error "device busy."
155 179
156 - intr|nointr
180 +FILES
181 + /etc/mnttab Table of mounted file systems.
157 182
158 - Enable (or disable) cancellation of smbfs(7FS) I/O operations
159 - when the user interrupts the calling thread (for example, by
160 - hitting Ctrl-C while an operation is underway). The default is
161 - intr (interruption enabled), so cancellation is normally
162 - allowed.
183 + /etc/dfs/fstypes Default distributed file system type.
163 184
185 + /etc/vfstab Table of automatically mounted
186 + resources.
164 187
165 - noprompt
188 + $HOME/.nsmbrc User-settable mount point configuration
189 + file to store the description for each
190 + connection.
166 191
167 - Suppresses the prompting for a password when mounting a share.
168 - This property enables you to permit anonymous access to a
169 - share. Anonymous access does not require a password.
170 -
171 - The mount operation fails if a password is required, the
172 - noprompt property is set, and no password is stored by the
173 - smbutil login command.
174 -
175 -
176 - retry_count=number
177 -
178 - Specifies the number of SMBFS retries to attempt before the
179 - connection is marked as broken. By default, 4 attempts are
180 - made.
181 -
182 - The retry_count property value set by the mount command
183 - overrides the global value set in SMF or the value set in your
184 - .nsmbrc file.
185 -
186 -
187 - timeout=seconds
188 -
189 - Specifies the CIFS request timeout. By default, the timeout is
190 - 15 seconds.
191 -
192 - The timeout property value set by the mount command overrides
193 - the global value set in SMF or the value set in your .nsmbrc
194 - file.
195 -
196 -
197 - uid=userid
198 -
199 - Assigns the specified user ID files. The default value is the
200 - owner ID of the directory where the volume is mounted.
201 -
202 -
203 - xattr|noxattr
204 -
205 - Enable (or disable) Solaris Extended Attributes in this mount
206 - point. This option defaults to xattr (enabled Extended
207 - Attributes), but note: if the CIFS server does not support CIFS
208 - "named streams", smbfs(7FS) forces this option to noxattr. When
209 - a mount has the noxattr option, attempts to use Solaris
210 - Extended attributes fail with EINVAL.
211 -
212 -
213 -
214 - -O
215 -
216 - Overlays mount. Allow the file system to be mounted over an
217 - existing mount point, making the underlying file system
218 - inaccessible. If a mount is attempted on a pre-existing mount point
219 - without setting this flag, the mount fails, producing the error
220 - "device busy."
221 -
222 -
223 192 EXAMPLES
224 - Example 1 Mounting an SMBFS Share
193 + Example 1 Mounting an SMBFS Share
194 + The following example shows how to mount the /tmp share from the
195 + nano server in the SALES workgroup on the local /mnt mount point.
196 + You must supply the password for the root user to successfully
197 + perform the mount operation.
225 198
199 + # mount -F smbfs "//SALES;root@nano.sfbay/tmp" /mnt
200 + Password:
226 201
227 - The following example shows how to mount the /tmp share from the nano
228 - server in the SALES workgroup on the local /mnt mount point. You must
229 - supply the password for the root user to successfully perform the mount
230 - operation.
202 + Example 2 Verifying That an SMBFS File System Is Mounted
203 + The following example shows how to mount the /tmp share from the
204 + nano server on the local /mnt mount point. You must supply the
205 + password for the root user to successfully perform the mount
206 + operation.
231 207
208 + # mount -F smbfs //root@nano.sfbay/tmp /mnt
209 + Password:
232 210
233 - # mount -F smbfs "//SALES;root@nano.sfbay/tmp" /mnt
234 - Password:
211 + You can verify that the share is mounted in the following ways:
235 212
213 + o View the file system entry in the /etc/mnttab file.
236 214
215 + # grep root /etc/mnttab
216 + //root@nano.sfbay/tmp /mnt smbfs dev=4900000 1177097833
237 217
238 - Example 2 Verifying That an SMBFS File System Is Mounted
218 + o View the output of the `mount' command.
239 219
220 + # mount | grep root
221 + /mnt on //root@nano.sfbay/tmp read/write/setuid/devices/dev=4900000 on
222 + Fri Apr 20 13:37:13 2007
240 223
241 - The following example shows how to mount the /tmp share from the nano
242 - server on the local /mnt mount point. You must supply the password for
243 - the root user to successfully perform the mount operation.
224 + o View the output of the `df /mnt' command.
244 225
226 + # df /mnt
227 + /mnt (//root@nano.sfbay/tmp): 3635872 blocks -1 files
245 228
246 - # mount -F smbfs //root@nano.sfbay/tmp /mnt
247 - Password:
229 + Obtain information about the mounted share by viewing the output
230 + of the `df -k /mnt' command.
248 231
232 + # df -k /mnt
233 + Filesystem kbytes used avail capacity Mounted on
234 + //root@nano.sfbay/tmp
235 + 1882384 64448 1817936 4% /mnt
249 236
237 + Example 3 Unmounting an SMB Share
238 + This example assumes that an SMB share has been mounted on the
239 + /mnt mount point. The following command line unmounts the share
240 + from the mount point.
250 241
242 + # umount /mnt
251 243
252 - You can verify that the share is mounted in the following ways:
244 +INTERFACE STABILITY
245 + Committed
253 246
254 - o View the file system entry in the /etc/mnttab file.
255 -
256 - # grep root /etc/mnttab
257 - //root@nano.sfbay/tmp /mnt smbfs dev=4900000 1177097833
258 -
259 -
260 -
261 - o View the output of the mount command.
262 -
263 - # mount | grep root
264 - /mnt on //root@nano.sfbay/tmp read/write/setuid/devices/dev=4900000 on
265 - Fri Apr 20 13:37:13 2007
266 -
267 -
268 -
269 - o View the output of the df /mnt command.
270 -
271 - # df /mnt
272 - /mnt (//root@nano.sfbay/tmp): 3635872 blocks -1 files
273 -
274 -
275 -
276 -
277 - Obtain information about the mounted share by viewing the output of the
278 - df -k /mnt command.
279 -
280 -
281 - # df -k /mnt
282 - Filesystem kbytes used avail capacity Mounted on
283 - //root@nano.sfbay/tmp
284 - 1882384 64448 1817936 4% /mnt
285 -
286 -
287 -
288 - Example 3 Unmounting a CIFS Share
289 -
290 -
291 - This example assumes that a CIFS share has been mounted on the /mnt
292 - mount point. The following command line unmounts the share from the
293 - mount point.
294 -
295 -
296 - # umount /mnt
297 -
298 -
299 -
300 -FILES
301 - /etc/mnttab
302 -
303 - Table of mounted file systems.
304 -
305 -
306 - /etc/dfs/fstypes
307 -
308 - Default distributed file system type.
309 -
310 -
311 - /etc/vfstab
312 -
313 - Table of automatically mounted resources.
314 -
315 -
316 - $HOME/.nsmbrc
317 -
318 - User-settable mount point configuration file to store the
319 - description for each connection.
320 -
321 -
322 -ATTRIBUTES
323 - See the attributes(5) man page for descriptions of the following
324 - attributes:
325 -
326 -
327 -
328 -
329 - +--------------------+-----------------+
330 - | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
331 - +--------------------+-----------------+
332 - |Interface Stability | Committed |
333 - +--------------------+-----------------+
334 -
335 247 SEE ALSO
336 - ldap(1), smbutil(1), mount(1M), mountall(1M), svcadm(1M), acl(2),
337 - fcntl(2), link(2), mknod(2), mount(2), symlink(2), umount(2),
338 - mnttab(4), nsmbrc(4), vfstab(4), attributes(5), pcfs(7FS), smbfs(7FS)
248 + ldap(1), smbutil(1), mount(1M), mountall(1M), svcadm(1M), acl(2),
249 + fcntl(2), link(2), mknod(2), mount(2), symlink(2), umount(2), mnttab(4),
250 + nsmbrc(4), vfstab(4), attributes(5), pcfs(7FS), smbfs(7FS)
339 251
340 252 AUTHORS
341 - This manual page contains material originally authored by Boris Popov,
342 - bpATbutya.kz, bpATFreeBSD.org.
253 + This manual page contains material originally authored by Boris Popov
254 + <bp@butya.kz>, <bp@FreeBSD.org>.
343 255
344 256 NOTES
345 - The Solaris CIFS client always attempts to use gethostbyname() to
346 - resolve host names. If the host name cannot be resolved, the CIFS
347 - client uses NetBIOS name resolution (NBNS). By default, the Solaris
348 - CIFS client permits the use of NBNS to enable Solaris CIFS clients in
349 - Windows environments to work without additional configuration.
257 + The SMB client always attempts to use gethostbyname(3NSL) to resolve host
258 + names. If the host name cannot be resolved, the SMB client uses NetBIOS
259 + name resolution (NBNS). By default, the SMB client permits the use of
260 + NBNS to enable SMB clients in Windows environments to work without
261 + additional configuration.
350 262
263 + Since NBNS has been exploited in the past, you might want to disable it.
264 + To disable NBNS, set the nbns-enabled service management facility
265 + property to false. By default, nbns-enabled is set to true.
351 266
352 - Since NBNS has been exploited in the past, you might want to disable
353 - it. To disable NBNS, set the nbns-enabled service management facility
354 - property to false. By default, nbns-enabled is set to true.
267 + If the directory on which a file system is to be mounted is a symbolic
268 + link, the file system is mounted on the directory to which the symbolic
269 + link refers, rather than being mounted on top of the symbolic link
270 + itself.
355 271
356 -
357 - If the directory on which a file system is to be mounted is a symbolic
358 - link, the file system is mounted on the directory to which the symbolic
359 - link refers, rather than being mounted on top of the symbolic link
360 - itself.
361 -
362 -
363 -
364 - January 2, 2012 MOUNT_SMBFS(1M)
272 +NexentaStor March 4, 2018 NexentaStor
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX