source: branches/samba-3.2.x/docs/manpages/mount.cifs.8@ 229

Last change on this file since 229 was 229, checked in by Herwig Bauernfeind, 17 years ago

Update 3.2 branch to 3.2.7 docs

File size: 19.0 KB
Line 
1.\" Title: mount.cifs
2.\" Author:
3.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
4.\" Date: 12/19/2008
5.\" Manual: System Administration tools
6.\" Source: Samba 3.2
7.\"
8.TH "MOUNT\.CIFS" "8" "12/19/2008" "Samba 3\.2" "System Administration tools"
9.\" disable hyphenation
10.nh
11.\" disable justification (adjust text to left margin only)
12.ad l
13.SH "NAME"
14mount.cifs - mount using the Common Internet File System (CIFS)
15.SH "SYNOPSIS"
16.HP 1
17mount\.cifs {service} {mount\-point} [\-o\ options]
18.SH "DESCRIPTION"
19.PP
20This tool is part of the
21\fBsamba\fR(7)
22suite\.
23.PP
24mount\.cifs mounts a Linux CIFS filesystem\. It is usually invoked indirectly by the
25\fBmount\fR(8)
26command when using the "\-t cifs" option\. This command only works in Linux, and the kernel must support the cifs filesystem\. The CIFS protocol is the successor to the SMB protocol and is supported by most Windows servers and many other commercial servers and Network Attached Storage appliances as well as by the popular Open Source server Samba\.
27.PP
28The mount\.cifs utility attaches the UNC name (exported network resource) to the local directory
29\fImount\-point\fR\. It is possible to set the mode for mount\.cifs to setuid root to allow non\-root users to mount shares to directories for which they have write permission\.
30.PP
31Options to
32\fImount\.cifs\fR
33are specified as a comma\-separated list of key=value pairs\. It is possible to send options other than those listed here, assuming that the cifs filesystem kernel module (cifs\.ko) supports them\. Unrecognized cifs mount options passed to the cifs vfs kernel code will be logged to the kernel log\.
34.PP
35\fImount\.cifs\fR
36causes the cifs vfs to launch a thread named cifsd\. After mounting it keeps running until the mounted resource is unmounted (usually via the umount utility)\.
37.SH "OPTIONS"
38.PP
39user=\fIarg\fR
40.RS 4
41specifies the username to connect as\. If this is not given, then the environment variable
42\fIUSER\fR
43is used\. This option can also take the form "user%password" or "workgroup/user" or "workgroup/user%password" to allow the password and workgroup to be specified as part of the username\.
44.sp
45.it 1 an-trap
46.nr an-no-space-flag 1