From 3db52feb1f3b2c07ce0b06ad4a7099fa6efe3fc7 Mon Sep 17 00:00:00 2001 From: Andrew Tridgell Date: Mon, 13 Dec 1999 13:27:58 +0000 Subject: first pass at updating head branch to be to be the same as the SAMBA_2_0 branch (This used to be commit 453a822a76780063dff23526c35408866d0c0154) --- docs/manpages/smbmount.8 | 131 +++++++++++++++++++++++++++++++---------------- 1 file changed, 87 insertions(+), 44 deletions(-) (limited to 'docs/manpages/smbmount.8') diff --git a/docs/manpages/smbmount.8 b/docs/manpages/smbmount.8 index 4ac7267395..457a940ddb 100644 --- a/docs/manpages/smbmount.8 +++ b/docs/manpages/smbmount.8 @@ -1,44 +1,87 @@ -.TH SMBMOUNT 8 "13 Nov 1998" "smbmount 2.0.0-beta1" -.SH NAME -smbmount \- mount smb file system -.SH SYNOPSIS -.B smbmount -[ -.B options -] - -.SH DESCRIPTION -.B smbmount -is a stripped-down version of the -.BI smbclient (1) -program used to mount smbfs shares. It implements only the mount command, -which then calls the -.BI smbmnt (8) -program to do the actual mount. -.B smbmount -itself accepts most of the options that -.B smbclient -does. See the -.BI smbclient (1) -manpage for details. - -To mount an smb file system, I suggest using the option -.B -c -for smbmount to pass the mount command. For example, use - -smbmount '\\\\server\\tmp' -c 'mount /mnt -u 123 -g 456' - -to mount the tmp share of server on /mnt, giving it a local uid 123 -and a local gid 456. - -The arguments supplied to the mount command are passed directly to the -.B smbmnt -utility for processing. -Refer to the -.BI smbmnt (8) -manpage for details. - -.SH SEE ALSO -.BI smbmnt (8), -.BI smbclient (1) - +.TH "smbmount " "1" "25 September 1999" "Samba" "SAMBA" +.PP +.SH "NAME" +smbmount \- mount an SMB filesystem +.PP +.SH "SYNOPSIS" +\fBsmbmount\fP service mountpoint [ -o options ] +.PP +.SH "DESCRIPTION" +.PP +smbmount mounts a SMB filesystem\&. It is usually invoked as mount\&.smb +from the mount(8) command when using the "-t smb" option\&. The kernel +must support the smbfs filesystem\&. +.PP +Options to smbmount are specified as a comma separated list of +key=value pairs\&. +.PP +NOTE: smbmount calls smbmnt to do the actual mount\&. You must make sure +that smbmnt is in the path so that it can be found\&. +.PP +.IP "\fBusername=\fP" +specifies the username to connect as\&. If this is +not given then the environment variable USER is used\&. This option can +also take the form user%password or user/workgroup or +user/workgroup%password to allow the password and workgroup to be +specified as part of the username\&. +.IP +.IP "\fBpassword=\fP" +specifies the SMB password\&. If not given then +smbmount will prompt for a passeword, unless the guest option is +given\&. +.IP +.IP "\fBnetbiosname=\fP" +sets the source NetBIOS name\&. It defaults to +the local hostname\&. +.IP +.IP "\fBuid=\fP" +sets the uid that files will be mounted as\&. It may be +specified as either a username or a numeric uid\&. +.IP +.IP "\fBgid=\fP" +sets the gid that files will be mounted as\&. It may be +specified as either a groupname or a numeric gid\&. +.IP +.IP "\fBport=\fP" +sets the remote SMB port number\&. The default is 139\&. +.IP +.IP "\fBfmask=\fP" +sets the file mask\&. This deterines the permissions +that remote files have in the local filesystem\&. The default is based +on the current umask\&. +.IP +.IP "\fBdmask=\fP" +sets the directory mask\&. This deterines the +permissions that remote directories have in the local filesystem\&. The +default is based on the current umask\&. +.IP +.IP "\fBdebug=\fP" +sets the debug level\&. This is useful for tracking +down SMB connection problems\&. +.IP +.IP "\fBip=\fP" +sets the destination host or IP address\&. +.IP +.IP "\fBworkgroup=\fP" +sets the workgroup on the destination +.IP +.IP "\fBsockopt=\fP" +sets the TCP socket options\&. See the smb\&.conf +"socket options" option\&. +.IP +.IP "\fBscope=\fP" +sets the NetBIOS scope +.IP +.IP "\fBguest\fP" +don\'t prompt for a password +.IP +.IP "\fBro\fP" +mount read-only +.IP +.IP "\fBrw\fP" +mount read-write +.IP +.PP +.SH "AUTHOR" +The maintainer of smbfs, smbmnt and smbmount is Andrew Tridgell +\fItridge@samba\&.org\fP -- cgit