[SCM] Samba Shared Repository - branch v3-0-test updated -
release-3-0-28a-1167-g4e66123
Karolin Seeger
kseeger at samba.org
Thu May 15 13:59:30 GMT 2008
The branch, v3-0-test has been updated
via 4e6612320f1c6d44e98571485f49d647a776edb2 (commit)
from 9727d87e7c8748fecf7df5664320507711a7d081 (commit)
http://gitweb.samba.org/?p=samba.git;a=shortlog;h=v3-0-test
- Log -----------------------------------------------------------------
commit 4e6612320f1c6d44e98571485f49d647a776edb2
Author: Karolin Seeger <kseeger at samba.org>
Date: Thu May 15 15:54:20 2008 +0200
man pages: Downgrade the man pages according to the code.
Karolin
-----------------------------------------------------------------------
Summary of changes:
docs-xml/manpages-3/smbmnt.8.xml | 118 +++++++
docs-xml/manpages-3/smbmount.8.xml | 344 ++++++++++++++++++++
docs-xml/manpages-3/smbumount.8.xml | 78 +++++
docs-xml/smbdotconf/base/configbackend.xml | 26 --
.../smbdotconf/browse/administrative_share.xml | 16 -
.../smbdotconf/ldap/clientldapsaslwrapping.xml | 44 ---
docs-xml/smbdotconf/logging/debugclass.xml | 18 -
docs-xml/smbdotconf/logging/ldapdebuglevel.xml | 28 --
docs-xml/smbdotconf/logging/ldapdebugthreshold.xml | 16 -
docs-xml/smbdotconf/misc/registryshares.xml | 24 --
.../smbdotconf/protocol/minreceivefilesize.xml | 22 --
docs-xml/smbdotconf/security/clientlanmanauth.xml | 2 +-
.../smbdotconf/security/clientplaintextauth.xml | 2 +-
docs-xml/smbdotconf/security/lanmanauth.xml | 2 +-
.../smbdotconf/winbind/winbindexpandgroups.xml | 24 --
docs-xml/smbdotconf/winbind/winbindrpconly.xml | 16 -
16 files changed, 543 insertions(+), 237 deletions(-)
create mode 100644 docs-xml/manpages-3/smbmnt.8.xml
create mode 100644 docs-xml/manpages-3/smbmount.8.xml
create mode 100644 docs-xml/manpages-3/smbumount.8.xml
delete mode 100644 docs-xml/smbdotconf/base/configbackend.xml
delete mode 100644 docs-xml/smbdotconf/browse/administrative_share.xml
delete mode 100644 docs-xml/smbdotconf/ldap/clientldapsaslwrapping.xml
delete mode 100644 docs-xml/smbdotconf/logging/debugclass.xml
delete mode 100644 docs-xml/smbdotconf/logging/ldapdebuglevel.xml
delete mode 100644 docs-xml/smbdotconf/logging/ldapdebugthreshold.xml
delete mode 100644 docs-xml/smbdotconf/misc/registryshares.xml
delete mode 100644 docs-xml/smbdotconf/protocol/minreceivefilesize.xml
delete mode 100644 docs-xml/smbdotconf/winbind/winbindexpandgroups.xml
delete mode 100644 docs-xml/smbdotconf/winbind/winbindrpconly.xml
Changeset truncated at 500 lines:
diff --git a/docs-xml/manpages-3/smbmnt.8.xml b/docs-xml/manpages-3/smbmnt.8.xml
new file mode 100644
index 0000000..9425ce7
--- /dev/null
+++ b/docs-xml/manpages-3/smbmnt.8.xml
@@ -0,0 +1,118 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
+<refentry id="smbmnt.8">
+
+<refmeta>
+ <refentrytitle>smbmnt</refentrytitle>
+ <manvolnum>8</manvolnum>
+</refmeta>
+
+
+<refnamediv>
+ <refname>smbmnt</refname>
+ <refpurpose>helper utility for mounting SMB filesystems</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+ <cmdsynopsis>
+ <command>smbmnt</command>
+ <arg choice="req">mount-point</arg>
+ <arg choice="opt">-s <share></arg>
+ <arg choice="opt">-r</arg>
+ <arg choice="opt">-u <uid></arg>
+ <arg choice="opt">-g <gid></arg>
+ <arg choice="opt">-f <mask></arg>
+ <arg choice="opt">-d <mask></arg>
+ <arg choice="opt">-o <options></arg>
+ <arg choice="opt">-h</arg>
+ </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+ <title>DESCRIPTION</title>
+
+ <para><command>smbmnt</command> is a helper application used
+ by the smbmount program to do the actual mounting of SMB shares.
+ <command>smbmnt</command> can be installed setuid root if you want
+ normal users to be able to mount their SMB shares.</para>
+
+ <para>A setuid smbmnt will only allow mounts on directories owned
+ by the user, and that the user has write permission on.</para>
+
+ <para>The <command>smbmnt</command> program is normally invoked
+ by <citerefentry><refentrytitle>smbmount</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry>. It should not be invoked directly by users. </para>
+
+ <para>smbmount searches the normal PATH for smbmnt. You must ensure
+ that the smbmnt version in your path matches the smbmount used.</para>
+
+</refsect1>
+
+<refsect1>
+ <title>OPTIONS</title>
+
+ <variablelist>
+ <varlistentry>
+ <term>-r</term>
+ <listitem><para>mount the filesystem read-only
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>-u uid</term>
+ <listitem><para>specify the uid that the files will
+ be owned by </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>-g gid</term>
+ <listitem><para>specify the gid that the files will be
+ owned by </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>-f mask</term>
+ <listitem><para>specify the octal file mask applied
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>-d mask</term>
+ <listitem><para>specify the octal directory mask
+ applied </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>-o options</term>
+ <listitem><para>
+ list of options that are passed as-is to smbfs, if this
+ command is run on a 2.4 or higher Linux kernel.
+ </para></listitem>
+ </varlistentry>
+
+ &stdarg.help;
+
+ </variablelist>
+</refsect1>
+
+
+<refsect1>
+ <title>AUTHOR</title>
+
+ <para>Volker Lendecke, Andrew Tridgell, Michael H. Warfield
+ and others.</para>
+
+ <para>The current maintainer of smbfs and the userspace
+ tools <command>smbmount</command>, <command>smbumount</command>,
+ and <command>smbmnt</command> is <ulink
+ url="mailto:urban at teststation.com">Urban Widmark</ulink>.
+ The <ulink url="mailto:samba at samba.org">SAMBA Mailing list</ulink>
+ is the preferred place to ask questions regarding these programs.
+ </para>
+
+ <para>The conversion of this manpage for Samba 2.2 was performed
+ by Gerald Carter. The conversion to DocBook XML 4.2 for Samba 3.0
+ was done by Alexander Bokovoy.</para>
+</refsect1>
+
+</refentry>
diff --git a/docs-xml/manpages-3/smbmount.8.xml b/docs-xml/manpages-3/smbmount.8.xml
new file mode 100644
index 0000000..85d0458
--- /dev/null
+++ b/docs-xml/manpages-3/smbmount.8.xml
@@ -0,0 +1,344 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
+<refentry id="smbmount.8">
+
+<refmeta>
+ <refentrytitle>smbmount</refentrytitle>
+ <manvolnum>8</manvolnum>
+</refmeta>
+
+
+<refnamediv>
+ <refname>smbmount</refname>
+ <refpurpose>mount an smbfs filesystem</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+ <cmdsynopsis>
+ <command>smbmount</command>
+ <arg choice="req">service</arg>
+ <arg choice="req">mount-point</arg>
+ <arg choice="opt">-o options</arg>
+ </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+ <title>DESCRIPTION</title>
+
+ <para><command>smbmount</command> mounts a Linux SMB filesystem. It
+ is usually invoked as <command>mount.smbfs</command> by
+ the <citerefentry><refentrytitle>mount</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> command when using the
+ "-t smbfs" option. This command only works in Linux, and the kernel must
+ support the smbfs filesystem.</para>
+
+ <para>WARNING: <command>smbmount</command> is deprecated and not
+ maintained any longer. <command>mount.cifs</command> (mount -t cifs)
+ should be used instead of <command>smbmount</command>.</para>
+
+ <para>Options to <command>smbmount</command> are specified as a comma-separated
+ list of key=value pairs. It is possible to send options other
+ than those listed here, assuming that smbfs supports them. If
+ you get mount failures, check your kernel log for errors on
+ unknown options.</para>
+
+ <para><command>smbmount</command> is a daemon. After mounting it keeps running until
+ the mounted smbfs is umounted. It will log things that happen
+ when in daemon mode using the "machine name" smbmount, so
+ typically this output will end up in <filename>log.smbmount</filename>. The <command>
+ smbmount</command> process may also be called mount.smbfs.</para>
+
+ <note><para> <command>smbmount</command>
+ calls <citerefentry><refentrytitle>smbmnt</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> to do the actual mount. You
+ must make sure that <command>smbmnt</command> is in the path so
+ that it can be found. </para></note>
+
+</refsect1>
+
+<refsect1>
+ <title>OPTIONS</title>
+
+ <variablelist>
+ <varlistentry>
+ <term>username=<arg></term>
+ <listitem><para>
+ specifies the username to connect as. If this is not given, then the environment variable <envar> USER</envar>
+ 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.
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>password=<arg></term>
+ <listitem><para>
+ specifies the SMB password. If this option is not given then the environment
+ variable <literal>PASSWD</literal> is used. If it can find no password
+ <command>smbmount</command> will prompt for a password, unless the guest option is given.
+ </para>
+
+ <para>
+ Note that passwords which contain the argument delimiter character (i.e. a comma ',') will failed to be parsed
+ correctly on the command line. However, the same password defined in the PASSWD environment variable or a
+ credentials file (see below) will be read correctly.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>credentials=<filename></term>
+ <listitem><para>specifies a file that contains a username and/or password.
+The format of the file is:
+<programlisting>
+username=value
+password=value
+</programlisting></para>
+
+ <para>This is preferred over having passwords in plaintext in a
+ shared file, such as <filename>/etc/fstab</filename>. Be sure to protect any
+ credentials file properly.
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>krb</term>
+ <listitem><para>Use kerberos (Active Directory). </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>netbiosname=<arg></term>
+ <listitem><para>sets the source NetBIOS name. It defaults
+ to the local hostname. </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>uid=<arg></term>
+ <listitem><para>sets the uid that will own all files on
+ the mounted filesystem.
+ It may be specified as either a username or a numeric uid.
+ </para></listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>gid=<arg></term>
+ <listitem><para>sets the gid that will own all files on
+ the mounted filesystem.
+ It may be specified as either a groupname or a numeric
+ gid. </para></listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>port=<arg></term>
+ <listitem><para>sets the remote SMB port number. The default
+ is 445, fallback is 139. </para></listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>fmask=<arg></term>
+ <listitem><para>sets the file mask. This determines the
+ permissions that remote files have in the local filesystem.
+ This is not a umask, but the actual permissions for the files.
+ The default is based on the current umask. </para></listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>dmask=<arg></term>
+ <listitem><para>Sets the directory mask. This determines the
+ permissions that remote directories have in the local filesystem.
+ This is not a umask, but the actual permissions for the directories.
+ The default is based on the current umask. </para></listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>debug=<arg></term>
+ <listitem><para>Sets the debug level. This is useful for
+ tracking down SMB connection problems. A suggested value to
+ start with is 4. If set too high there will be a lot of
+ output, possibly hiding the useful output.</para></listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>ip=<arg></term>
+ <listitem><para>Sets the destination host or IP address.
+ </para></listitem>
+ </varlistentry>
+
+
+
+ <varlistentry>
+ <term>workgroup=<arg></term>
+ <listitem><para>Sets the workgroup on the destination </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>sockopt=<arg></term>
+ <listitem><para>Sets the TCP socket options. See the <ulink
+ url="smb.conf.5.html#SOCKETOPTIONS"><citerefentry><refentrytitle>smb.conf</refentrytitle>
+ <manvolnum>5</manvolnum></citerefentry></ulink> <parameter>socket options</parameter> option.
+ </para></listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>scope=<arg></term>
+ <listitem><para>Sets the NetBIOS scope </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>guest</term>
+ <listitem><para>Don't prompt for a password </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>ro</term>
+ <listitem><para>mount read-only </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>rw</term><listitem><para>mount read-write </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>iocharset=<arg></term>
+ <listitem><para>
+ sets the charset used by the Linux side for codepage
+ to charset translations (NLS). Argument should be the
+ name of a charset, like iso8859-1. (Note: only kernel
+ 2.4.0 or later)
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>codepage=<arg></term>
+ <listitem><para>
+ sets the codepage the server uses. See the iocharset
+ option. Example value cp850. (Note: only kernel 2.4.0
+ or later)
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>ttl=<arg></term>
+ <listitem><para>
+ sets how long a directory listing is cached in milliseconds
+ (also affects visibility of file size and date
+ changes). A higher value means that changes on the
+ server take longer to be noticed but it can give
+ better performance on large directories, especially
+ over long distances. Default is 1000ms but something
+ like 10000ms (10 seconds) is probably more reasonable
+ in many cases.
+ (Note: only kernel 2.4.2 or later)
+ </para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+
+</refsect1>
+
+<refsect1>
+ <title>ENVIRONMENT VARIABLES</title>
+
+ <para>The variable <envar>USER</envar> may contain the username of the
+ person using the client. This information is used only if the
+ protocol level is high enough to support session-level
+ passwords. The variable can be used to set both username and
+ password by using the format username%password.</para>
+
+ <para>The variable <envar>PASSWD</envar> may contain the password of the
+ person using the client. This information is used only if the
+ protocol level is high enough to support session-level
+ passwords.</para>
+
+ <para>The variable <envar>PASSWD_FILE</envar> may contain the pathname
+ of a file to read the password from. A single line of input is
+ read and used as the password.</para>
+</refsect1>
+
+<refsect1>
+ <title>OTHER COMMANDS</title>
+
+ <para>
+ File systems that have been mounted using the <command>smbmount</command>
+ can be unmounted using the <command>smbumount</command> or the UNIX system
+ <command>umount</command> command.
+ </para>
+
+</refsect1>
+
+
+<refsect1>
+ <title>BUGS</title>
+
+ <para>Passwords and other options containing , can not be handled.
+ For passwords an alternative way of passing them is in a credentials
+ file or in the PASSWD environment.</para>
+
+ <para>The credentials file does not handle usernames or passwords with
+ leading space.</para>
+
+ <para>One smbfs bug is important enough to mention here, even if it
+ is a bit misplaced:</para>
+
+ <itemizedlist>
+
+ <listitem><para>Mounts sometimes stop working. This is usually
+ caused by smbmount terminating. Since smbfs needs smbmount to
+ reconnect when the server disconnects, the mount will eventually go
+ dead. An umount/mount normally fixes this. At least 2 ways to
+ trigger this bug are known.</para></listitem>
+
+ </itemizedlist>
+
+ <para>Note that the typical response to a bug report is suggestion
+ to try the latest version first. So please try doing that first,
+ and always include which versions you use of relevant software
+ when reporting bugs (minimum: samba, kernel, distribution)</para>
+
+</refsect1>
+
+
+<refsect1>
+ <title>SEE ALSO</title>
+
+ <para>Documentation/filesystems/smbfs.txt in the linux kernel
+ source tree may contain additional options and information.</para>
+
+ <para>FreeBSD also has a smbfs, but it is not related to smbmount</para>
+
+ <para>For Solaris, HP-UX and others you may want to look at <citerefentry><refentrytitle>smbsh</refentrytitle>
+ <manvolnum>1</manvolnum></citerefentry> or at other solutions, such as
+ Sharity or perhaps replacing the SMB server with a NFS server.</para>
+
+</refsect1>
+
+
+<refsect1>
+ <title>AUTHOR</title>
+
+ <para>Volker Lendecke, Andrew Tridgell, Michael H. Warfield
+ and others.</para>
+
+ <para>The current maintainer of smbfs and the userspace
+ tools <command>smbmount</command>, <command>smbumount</command>,
+ and <command>smbmnt</command> is <ulink
+ url="mailto:urban at teststation.com">Urban Widmark</ulink>.
+ The <ulink url="mailto:samba at samba.org">SAMBA Mailing list</ulink>
+ is the preferred place to ask questions regarding these programs.
+ </para>
+
+ <para>The conversion of this manpage for Samba 2.2 was performed
+ by Gerald Carter. The conversion to DocBook XML 4.2 for Samba 3.0
+ was done by Alexander Bokovoy.</para>
+</refsect1>
+
+</refentry>
diff --git a/docs-xml/manpages-3/smbumount.8.xml b/docs-xml/manpages-3/smbumount.8.xml
new file mode 100644
index 0000000..9a214fb
--- /dev/null
+++ b/docs-xml/manpages-3/smbumount.8.xml
@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
+<refentry id="smbumount.8">
+
+<refmeta>
+ <refentrytitle>smbumount</refentrytitle>
+ <manvolnum>8</manvolnum>
+</refmeta>
+
+
+<refnamediv>
+ <refname>smbumount</refname>
+ <refpurpose>smbfs umount for normal users</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+ <cmdsynopsis>
+ <command>smbumount</command>
+ <arg choice="req">mount-point</arg>
+ </cmdsynopsis>
--
Samba Shared Repository
More information about the samba-cvs
mailing list