From 4bca9fd8d4c57c9bcd36c8ed9924a866540ddd65 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Thu, 22 Feb 2001 18:53:07 +0000 Subject: while I was at it..... (This used to be commit 723bcb57e8bd54a36f2c217246f78a4301b6b25b) --- docs/docbook/manpages/smbmnt.8.sgml | 97 ++++++++++++ docs/docbook/manpages/smbmount.8.sgml | 181 ++++++++++++++++++++++ docs/docbook/manpages/smbumount.8.sgml | 67 +++++++++ docs/htmldocs/smbmnt.8.html | 156 +++++++++++++++++++ docs/htmldocs/smbmount.8.html | 264 +++++++++++++++++++++++++++++++++ docs/htmldocs/smbumount.8.html | 130 ++++++++++++++++ docs/manpages/smbmnt.8 | 85 ++++++----- docs/manpages/smbmount.8 | 186 ++++++++++++----------- docs/manpages/smbumount.8 | 61 ++++---- 9 files changed, 1078 insertions(+), 149 deletions(-) create mode 100644 docs/docbook/manpages/smbmnt.8.sgml create mode 100644 docs/docbook/manpages/smbmount.8.sgml create mode 100644 docs/docbook/manpages/smbumount.8.sgml create mode 100644 docs/htmldocs/smbmnt.8.html create mode 100644 docs/htmldocs/smbmount.8.html create mode 100644 docs/htmldocs/smbumount.8.html (limited to 'docs') diff --git a/docs/docbook/manpages/smbmnt.8.sgml b/docs/docbook/manpages/smbmnt.8.sgml new file mode 100644 index 0000000000..e25c73d092 --- /dev/null +++ b/docs/docbook/manpages/smbmnt.8.sgml @@ -0,0 +1,97 @@ + + + + + smbmnt + 8 + + + + + smbmnt + helper utility for mounting SMB filesystems + + + + + smbumount + mount-point + -s <share> + -r + -u <uid> + -g <gid> + -f <mask> + -d <mask> + + + + + DESCRIPTION + + smbmnt is a helper application used + by the smbmount program to do the actual mounting of SMB shares. + smbmnt is meant to be installed setuid root + so that normal users can mount their smb shares. It checks + whether the user has write permissions on the mount point and + then mounts the directory. + + The smbmnt program is normally invoked + by smbmount(8) + . It should not be invoked directly by users. + + + + OPTIONS + + + + -r + mount the filesystem read-only + + + + + + -u uid + specify the uid that the files will + be owned by + + + + -g gid + specify the gid that the files will be + owned by + + + + + + -f mask + specify the octal file mask applied + + + + + + + -d mask + specify the octal directory mask + applied + + + + + + + AUTHOR + + The current maintainer of smbfs and the userspace + tools smbmount, smbumount, + and smbmnt is Urban Widmark. + + The conversion of this manpage for Samba 2.2 was performed + by Gerald Carter + + + diff --git a/docs/docbook/manpages/smbmount.8.sgml b/docs/docbook/manpages/smbmount.8.sgml new file mode 100644 index 0000000000..a1a510ecd7 --- /dev/null +++ b/docs/docbook/manpages/smbmount.8.sgml @@ -0,0 +1,181 @@ + + + + + smbmount + 8 + + + + + smbmount + mount and smbfs filesystem + + + + + smbumount + service + mount-point + -o options + + + + + DESCRIPTION + + 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. + + Options to smbmount are specified as a comma separated list + of key=value pairs. + + NOTE: smbmount + calls smbmnt(8) to do the actual mount. You + must make sure that smbmnt is in the path so + that it can be found. + + + + + OPTIONS + + + + username=<arg> + 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. + + + + + password=<arg> + specifies the SMB password. If not given then + smbmount will prompt for a passeword, unless + the guest option is given. + + + + + + netbiosname=<arg> + sets the source NetBIOS name. It defaults + to the local hostname. + + + + + + uid=<arg> + sets the uid that files will be mounted as. + It may be specified as either a username or a numeric uid. + + + + + + gid=<arg> + sets the gid that files will be mounted as. + It may be specified as either a groupname or a numeric + gid. + + + + + port=<arg> + sets the remote SMB port number. The default + is 139. + + + + + fmask=<arg> + sets the file mask. This determines the + permissions that remote files have in the local filesystem. + The default is based on the current umask. + + + + + dmask=<arg> + sets the directory mask. This deterines the + permissions that remote directories have in the local filesystem. + The default is based on the current umask. + + + + + debug=<arg> + sets the debug level. This is useful for + tracking down SMB connection problems. + + + + + ip=<arg> + sets the destination host or IP address. + + + + + + + workgroup=<arg> + sets the workgroup on the destination + + + + + + sockopt=<arg> + sets the TCP socket options. See the smb.conf + socket options option. + + + + + + scope=<arg> + sets the NetBIOS scope + + + + guest + don't prompt for a password + + + + + ro + mount read-only + + + + rwmount read-write + + + + + + + + + AUTHOR + + The current maintainer of smbfs and the userspace + tools smbmount, smbumount, + and smbmnt is Urban Widmark + + The conversion of this manpage for Samba 2.2 was performed + by Gerald Carter + + + diff --git a/docs/docbook/manpages/smbumount.8.sgml b/docs/docbook/manpages/smbumount.8.sgml new file mode 100644 index 0000000000..be7e929e06 --- /dev/null +++ b/docs/docbook/manpages/smbumount.8.sgml @@ -0,0 +1,67 @@ + + + + + smbumount + 8 + + + + + smbumount + smbfs umount for normal users + + + + + smbumount + mount-point + + + + + DESCRIPTION + + With this program, normal users can unmount smb-filesystems, + provided that it is suid root. smbumount has + been written to give normal linux-users more control over their + resources. It is safe to install this program suid root, because only + the user who has mounted a filesystem is allowed to unmount it again. + For root it is not necessary to use smbumount. The normal umount + program works perfectly well, but it would certainly be problematic + to make umount setuid root. + + + + OPTIONS + + + + mount-point + The directory to unmount. + + + + + + + SEE ALSO + + smbmount(8) + + + + + + AUTHOR + + The current maintainer of smbfs and the userspace + tools smbmount, smbumount, + and smbmnt is Urban Widmark. + + The conversion of this manpage for Samba 2.2 was performed + by Gerald Carter + + + diff --git a/docs/htmldocs/smbmnt.8.html b/docs/htmldocs/smbmnt.8.html new file mode 100644 index 0000000000..051684a291 --- /dev/null +++ b/docs/htmldocs/smbmnt.8.html @@ -0,0 +1,156 @@ +smbmnt

smbmnt

Name

smbmnt -- helper utility for mounting SMB filesystems

Synopsis

smbumount {mount-point} [-s <share>] [-r] [-u <uid>] [-g <gid>] [-f <mask>] [-d <mask>]

DESCRIPTION

smbmnt is a helper application used + by the smbmount program to do the actual mounting of SMB shares. + smbmnt is meant to be installed setuid root + so that normal users can mount their smb shares. It checks + whether the user has write permissions on the mount point and + then mounts the directory.

The smbmnt program is normally invoked + by smbmount(8) + . It should not be invoked directly by users.

OPTIONS

-r

mount the filesystem read-only +

-u uid

specify the uid that the files will + be owned by

-g gid

specify the gid that the files will be + owned by

-f mask

specify the octal file mask applied +

-d mask

specify the octal directory mask + applied

AUTHOR

The current maintainer of smbfs and the userspace + tools smbmount, smbumount, + and smbmnt is Urban Widmark.

The conversion of this manpage for Samba 2.2 was performed + by Gerald Carter

\ No newline at end of file diff --git a/docs/htmldocs/smbmount.8.html b/docs/htmldocs/smbmount.8.html new file mode 100644 index 0000000000..94a4ae8bc8 --- /dev/null +++ b/docs/htmldocs/smbmount.8.html @@ -0,0 +1,264 @@ +smbmount

smbmount

Name

smbmount -- mount and smbfs filesystem

Synopsis

smbumount {service} {mount-point} [-o options]

DESCRIPTION

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.

Options to smbmount are specified as a comma separated list + of key=value pairs.

NOTE: smbmount + calls smbmnt(8) to do the actual mount. You + must make sure that smbmnt is in the path so + that it can be found.

OPTIONS

username=<arg>

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.

password=<arg>

specifies the SMB password. If not given then + smbmount will prompt for a passeword, unless + the guest option is given.

netbiosname=<arg>

sets the source NetBIOS name. It defaults + to the local hostname.

uid=<arg>

sets the uid that files will be mounted as. + It may be specified as either a username or a numeric uid. +

gid=<arg>

sets the gid that files will be mounted as. + It may be specified as either a groupname or a numeric + gid.

port=<arg>

sets the remote SMB port number. The default + is 139.

fmask=<arg>

sets the file mask. This determines the + permissions that remote files have in the local filesystem. + The default is based on the current umask.

dmask=<arg>

sets the directory mask. This deterines the + permissions that remote directories have in the local filesystem. + The default is based on the current umask.

debug=<arg>

sets the debug level. This is useful for + tracking down SMB connection problems.

ip=<arg>

sets the destination host or IP address. +

workgroup=<arg>

sets the workgroup on the destination

sockopt=<arg>

sets the TCP socket options. See the smb.conf + socket options option. +

scope=<arg>

sets the NetBIOS scope

guest

don't prompt for a password

ro

mount read-only

rw

mount read-write

AUTHOR

The current maintainer of smbfs and the userspace + tools smbmount, smbumount, + and smbmnt is Urban Widmark

The conversion of this manpage for Samba 2.2 was performed + by Gerald Carter

\ No newline at end of file diff --git a/docs/htmldocs/smbumount.8.html b/docs/htmldocs/smbumount.8.html new file mode 100644 index 0000000000..cdecec69a1 --- /dev/null +++ b/docs/htmldocs/smbumount.8.html @@ -0,0 +1,130 @@ +smbumount

smbumount

Name

smbumount -- smbfs umount for normal users

Synopsis

smbumount {mount-point}

DESCRIPTION

With this program, normal users can unmount smb-filesystems, + provided that it is suid root. smbumount has + been written to give normal linux-users more control over their + resources. It is safe to install this program suid root, because only + the user who has mounted a filesystem is allowed to unmount it again. + For root it is not necessary to use smbumount. The normal umount + program works perfectly well, but it would certainly be problematic + to make umount setuid root.

OPTIONS

mount-point

The directory to unmount.

SEE ALSO

smbmount(8) +

AUTHOR

The current maintainer of smbfs and the userspace + tools smbmount, smbumount, + and smbmnt is Urban Widmark.

The conversion of this manpage for Samba 2.2 was performed + by Gerald Carter

\ No newline at end of file diff --git a/docs/manpages/smbmnt.8 b/docs/manpages/smbmnt.8 index e8cc1f2cd9..fcba71f49a 100644 --- a/docs/manpages/smbmnt.8 +++ b/docs/manpages/smbmnt.8 @@ -1,37 +1,50 @@ -.TH "smbmnt " "1" "25 September 1999" "Samba" "SAMBA" -.PP -.SH "NAME" +.\" This manpage has been automatically generated by docbook2man-spec +.\" from a DocBook document. docbook2man-spec can be found at: +.\" +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng . +.TH "SMBMNT" "8" "22 February 2001" "" "" +.SH NAME smbmnt \- helper utility for mounting SMB filesystems -.PP -.SH "SYNOPSIS" -\fBsmbmnt\fP mount-point [ -s share ] [ -r ] [ -u uid ] [ -g gid ] [ -f mask ] [ -d mask ] -.PP -.SH "DESCRIPTION" -.PP -smbmnt is a helper application used by the smbmount program to do the -actual mounting of SMB shares\&. smbmnt is meant to be installed setuid -root so that normal users can mount their smb shares\&. It checks -whether the user has write permissions on the mount point and then -mounts the directory\&. -.PP -The smbmnt program is normally invoked by smbmount\&. It should not be -invoked directly by users\&. -.PP -.IP "\fB-r\fP" -mount the filesystem read-only -.PP -.IP "\fB-u uid\fP" -specify the uid that the files will be owned by -.PP -.IP "\fB-g gid\fP" -specify the gid that the files will be owned by -.PP -.IP "\fB-f mask\fP" -specify the octal file mask applied -.PP -.IP "\fB-d mask\fP" -specify the octal directory mask applied -.PP -.SH "AUTHOR" -The maintainer of smbfs, smbmnt and smbmount is Andrew Tridgell -\fItridge@samba\&.org\fP +.SH SYNOPSIS +.sp +\fBsmbumount\fR \fBmount-point\fR [ \fB-s \fR ] [ \fB-r\fR ] [ \fB-u \fR ] [ \fB-g \fR ] [ \fB-f \fR ] [ \fB-d \fR ] +.SH "DESCRIPTION" +.PP +\fBsmbmnt\fR is a helper application used +by the smbmount program to do the actual mounting of SMB shares. +\fBsmbmnt\fR is meant to be installed setuid root +so that normal users can mount their smb shares. It checks +whether the user has write permissions on the mount point and +then mounts the directory. +.PP +The \fBsmbmnt\fR program is normally invoked +by \fBsmbmount(8)\fR + . It should not be invoked directly by users. +.SH "OPTIONS" +.TP +\fB-r\fR +mount the filesystem read-only +.TP +\fB-u uid\fR +specify the uid that the files will +be owned by +.TP +\fB-g gid\fR +specify the gid that the files will be +owned by +.TP +\fB-f mask\fR +specify the octal file mask applied +.TP +\fB-d mask\fR +specify the octal directory mask +applied +.SH "AUTHOR" +.PP +The current maintainer of smbfs and the userspace +tools \fBsmbmount\fR, \fBsmbumount\fR, +and \fBsmbmnt\fR is Urban Widmark . +.PP +The conversion of this manpage for Samba 2.2 was performed +by Gerald Carter diff --git a/docs/manpages/smbmount.8 b/docs/manpages/smbmount.8 index 457a940ddb..de241824a4 100644 --- a/docs/manpages/smbmount.8 +++ b/docs/manpages/smbmount.8 @@ -1,87 +1,99 @@ -.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 +.\" This manpage has been automatically generated by docbook2man-spec +.\" from a DocBook document. docbook2man-spec can be found at: +.\" +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng . +.TH "SMBMOUNT" "8" "22 February 2001" "" "" +.SH NAME +smbmount \- mount and smbfs filesystem +.SH SYNOPSIS +.sp +\fBsmbumount\fR \fBservice\fR \fBmount-point\fR [ \fB-o options\fR ] +.SH "DESCRIPTION" +.PP +\fBsmbmount\fR mounts a SMB filesystem. It +is usually invoked as \fBmount.smb\fR from +the \fBmount(8)\fR 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 +\fBNOTE:\fR \fBsmbmount\fR +calls \fBsmbmnt(8)\fR to do the actual mount. You +must make sure that \fBsmbmnt\fR is in the path so +that it can be found. +.SH "OPTIONS" +.TP +\fBusername=\fR +specifies the username to connect as. If +this is not given then the environment variable \fI $USER\fR 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. +.TP +\fBpassword=\fR +specifies the SMB password. If not given then +\fBsmbmount\fR will prompt for a passeword, unless +the guest option is given. +.TP +\fBnetbiosname=\fR +sets the source NetBIOS name. It defaults +to the local hostname. +.TP +\fBuid=\fR +sets the uid that files will be mounted as. +It may be specified as either a username or a numeric uid. +.TP +\fBgid=\fR +sets the gid that files will be mounted as. +It may be specified as either a groupname or a numeric +gid. +.TP +\fBport=\fR +sets the remote SMB port number. The default +is 139. +.TP +\fBfmask=\fR +sets the file mask. This determines the +permissions that remote files have in the local filesystem. +The default is based on the current umask. +.TP +\fBdmask=\fR +sets the directory mask. This deterines the +permissions that remote directories have in the local filesystem. +The default is based on the current umask. +.TP +\fBdebug=\fR +sets the debug level. This is useful for +tracking down SMB connection problems. +.TP +\fBip=\fR +sets the destination host or IP address. +.TP +\fBworkgroup=\fR +sets the workgroup on the destination +.TP +\fBsockopt=\fR +sets the TCP socket options. See the \fIsmb.conf +\fR \fIsocket options\fR option. +.TP +\fBscope=\fR +sets the NetBIOS scope +.TP +\fBguest\fR +don't prompt for a password +.TP +\fBro\fR +mount read-only +.TP +\fBrw\fR +mount read-write +.SH "AUTHOR" +.PP +The current maintainer of smbfs and the userspace +tools \fBsmbmount\fR, \fBsmbumount\fR, +and \fBsmbmnt\fR is Urban Widmark +.PP +The conversion of this manpage for Samba 2.2 was performed +by Gerald Carter diff --git a/docs/manpages/smbumount.8 b/docs/manpages/smbumount.8 index 724684a221..1699b6bf6f 100644 --- a/docs/manpages/smbumount.8 +++ b/docs/manpages/smbumount.8 @@ -1,28 +1,37 @@ -.TH SMBUMOUNT 8 "18 May 1999" "smbumount 2.0.4" +.\" This manpage has been automatically generated by docbook2man-spec +.\" from a DocBook document. docbook2man-spec can be found at: +.\" +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng . +.TH "SMBUMOUNT" "8" "22 February 2001" "" "" .SH NAME -smbumount \- umount for normal users +smbumount \- smbfs umount for normal users .SH SYNOPSIS -.B smbumount -.B mount-point - -.SH DESCRIPTION -With this program, normal users can unmount smb-filesystems, provided -that it is suid root. - -.B smbumount -has been written to give normal linux-users more control over their -resources. It is safe to install this program suid root, because only -the user who has mounted a filesystem is allowed to unmount it again. - -For root it is not necessary to use smbumount. The normal umount -program works perfectly well, but it would certainly be problematic to -make umount setuid root. - -.SH OPTIONS -.B mount-point -.RS 3 -.B mount-point -is the directory you want to unmount. - -.SH SEE ALSO -.B smbmount(8) +.sp +\fBsmbumount\fR \fBmount-point\fR +.SH "DESCRIPTION" +.PP +With this program, normal users can unmount smb-filesystems, +provided that it is suid root. \fBsmbumount\fR has +been written to give normal linux-users more control over their +resources. It is safe to install this program suid root, because only +the user who has mounted a filesystem is allowed to unmount it again. +For root it is not necessary to use smbumount. The normal umount +program works perfectly well, but it would certainly be problematic +to make umount setuid root. +.SH "OPTIONS" +.TP +\fBmount-point\fR +The directory to unmount. +.SH "SEE ALSO" +.PP +\fBsmbmount(8)\fR + +.SH "AUTHOR" +.PP +The current maintainer of smbfs and the userspace +tools \fBsmbmount\fR, \fBsmbumount\fR, +and \fBsmbmnt\fR is Urban Widmark . +.PP +The conversion of this manpage for Samba 2.2 was performed +by Gerald Carter -- cgit