[smb4k] doc: Updated handbook.
Alexander Reinholdt
alexander.reinholdt at kdemail.net
Sat Oct 22 19:39:31 UTC 2016
Git commit 93a0d23efff879794687058b13f6b2790f0f55ae by Alexander Reinholdt.
Committed on 22/10/2016 at 19:39.
Pushed by areinholdt into branch 'master'.
Updated handbook.
M +45 -53 doc/index.docbook
http://commits.kde.org/smb4k/93a0d23efff879794687058b13f6b2790f0f55ae
diff --git a/doc/index.docbook b/doc/index.docbook
index 5ad86bf..4ab303b 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1392,11 +1392,14 @@
<sect1 id="special_remarks">
<title>Special Remarks</title>
-<!-- Using Smb4K : Special Remarks : Samba Security Fixes of April 12, 2016 -->
+<!--
+ Using Smb4K : Special Remarks : Samba Security Fixes of April 12, 2016
+-->
<sect2 id="special_remarks_samba_security_updates">
- <title>Remarks Regarding the Samba Security Fixes of April 12, 2016</title>
- <para>On April 12, 2016 the Samba team released security fixes for the <ulink url="http://www.badlock.org">Badlock bug</ulink>. Unfortunately, they also introduced a regression that causes the <command>net</command> command to fail on many systems when querying remote hosts. If you experience this issue, you can add two lines to the [global] section of your <filename>smb.conf</filename> file to make browsing work again:</para>
+ <title>Remarks Regarding the Samba Security Fixes of April 12, 2016</title>
+
+ <para>On April 12, 2016 the Samba team released security fixes for the <ulink url="http://www.badlock.org">Badlock bug</ulink>. Unfortunately, they also introduced a regression that causes the <command>net</command> command to fail on many systems when querying remote hosts. If you experience this issue, you can add two lines to the [global] section of your <filename>smb.conf</filename> file to make browsing work again:</para>
<programlisting>[global]
...
@@ -1404,63 +1407,52 @@ client max protocol = SMB3
client ipc max protocol = NT1
...</programlisting>
- <para>Unfortunately, this fix for &smb4k; breaks the possibility to connect to the network neighborhood with &dolphin; and maybe also other programs.</para>
-</sect2>
+ <para>Unfortunately, this fix for &smb4k; breaks the possibility to connect to the network neighborhood with &dolphin; and maybe also other programs.</para>
+ </sect2>
-<!-- Using Smb4K : Special Remarks : Remarks for FreeBSD Users -->
+<!--
+ Using Smb4K : Special Remarks : Remarks for FreeBSD Users
+-->
-<sect2 id="special_remarks_freebsd">
-<title>Remarks for FreeBSD Users</title>
+ <sect2 id="special_remarks_freebsd">
+ <title>Remarks for FreeBSD Users</title>
-<sect3 id="special_remarks_freebsd_installation">
-<title>DBUS and PolKit-1</title>
-<para>&smb4k; makes use of the &kde; authorization API (KAuth) to enable mounting of remote shares. KAuth uses DBUS and PolKit-1 (or PolicyKit) for privilege escalation, so it is necessary that &smb4k; is set up properly. When installing &smb4k; under FreeBSD, it might be necessary to manually adjust some things to achieve this (With version 1.0.10 of package <application>kdehier4</application> this seems to be fixed!):</para>
-<itemizedlist>
- <listitem>
- <para>Check that the file <filename>net.sourceforge.smb4k.mounthelper.policy</filename> exists in the directory <filename class="directory">/usr/local/share/polkit-1/actions/</filename>. If it is not present, you need to link (or copy) it to that location:
-<screen><userinput><prompt>$</prompt> <command>cd</command> <filename class="directory">/usr/local/share/polkit-1/actions/</filename></userinput>
-<userinput><prompt>$</prompt> <command>sudo ln</command> -s \
-<filename>/usr/local/kde4/share/polkit-1/actions/net.sourceforge.smb4k.mounthelper.policy</filename> .</userinput></screen></para>
- </listitem>
- <listitem>
- <para>The installation most likely put the DBUS files into the wrong location, so you have to link (or copy) them to the right one:
-<screen><userinput><prompt>$</prompt> <command>cd</command> <filename class="directory">/usr/local/share/dbus-1/system-services</filename></userinput>
-<userinput><prompt>$</prompt> <command>sudo ln</command> -s \
-<filename>/usr/local/kde4/share/dbus-1/system-services/net.sourceforge.smb4k.mounthelper.service</filename> .</userinput></screen></para>
- </listitem>
-</itemizedlist>
-</sect3>
+ <sect3 id="special_remarks_freebsd_mounting">
+ <title>Mounting of Shares (Smb4K >= 1.2.0)</title>
-<sect3 id="special_remarks_freebsd_mounting">
-<title>Mounting of Shares (Smb4K >= 1.2.0)</title>
-<para>Since version 1.2.0, the password for a share is directly passed to <command>mount_smbfs</command>, so that the <filename>~/.nsmbrc</filename> is not necessary anymore for mounting to work. Moreover, &smb4k; will not write any data to that file anymore.</para>
-</sect3>
-</sect2>
+ <para>Since version 1.2.0, the password for a share is directly passed to <command>mount_smbfs</command>, so that the <filename>~/.nsmbrc</filename> is not necessary anymore for mounting to work. Moreover, &smb4k; will not write any data to that file anymore.</para>
+ </sect3>
+ </sect2>
-<!-- Using Smb4K : Special Remarks : Remarks for NetBSD Users -->
+<!--
+ Using Smb4K : Special Remarks : Remarks for NetBSD Users
+-->
-<sect2 id="special_remarks_netbsd">
-<title>Remarks for NetBSD Users</title>
+ <sect2 id="special_remarks_netbsd">
+ <title>Remarks for NetBSD Users</title>
+
+ <sect3 id="special_remarks_netbsd_installation">
+ <title>DBUS and PolicyKit</title>
+
+ <para>Under NetBSD, &smb4k; is able to run since version 1.2.0. However, some modifications have to be made in order to be able to mount and unmount shares:</para>
+ <para>Assuming that the prefix of your &kde; installation is <filename class="directory">/usr/pkg</filename>, the following steps have to be taken to make &smb4k; work properly:</para>
+ <itemizedlist>
+ <listitem><para>Configure, compile and install &smb4k; according to the directions given in the <link linkend="appendix_compilation">Configuration, Compilation and Installation</link> section of the appendix.</para></listitem>
+ <listitem><para>After installation, link (or copy) the file <filename>net.sourceforge.smb4k.mounthelper.conf</filename> from the <filename class="directory">examples</filename> directory to the right location:</para>
+ <para><screen><userinput><prompt>$</prompt> <command>cd</command> <filename class="directory">/usr/pkg/etc/dbus-1/system.d/</filename></userinput>
+ <userinput><prompt>$</prompt> <command>sudo ln</command> -s \
+ <filename>/usr/pkg/share/examples/kde4-dbus/net.sourceforge.smb4k.mounthelper.conf</filename> .</userinput></screen></para></listitem>
+ <listitem><para>Edit the file <filename>/usr/pkg/etc/PolicyKit/PolicyKit.conf</filename> and add the following paragraph in the <config version="0.1"> section:</para>
+
+<programlisting>
+<match action="org.kde.smb4k.mounthelper.*">
+<return result="yes">
+</match></programlisting>
-<sect3 id="special_remarks_netbsd_installation">
- <title>DBUS and PolicyKit</title>
-<para>Under NetBSD, &smb4k; is able to run since version 1.2.0. However, some modifications have to be made in order to be able to mount and unmount shares:</para>
-<para>Assuming that the prefix of your &kde; installation is <filename class="directory">/usr/pkg</filename>, the following steps have to be taken to make &smb4k; work properly:</para>
-<itemizedlist>
- <listitem><para>Configure, compile and install &smb4k; according to the directions given in the <link linkend="appendix_compilation">Configuration, Compilation and Installation</link> section of the appendix.</para></listitem>
- <listitem><para>After installation, link (or copy) the file <filename>net.sourceforge.smb4k.mounthelper.conf</filename> from the <filename class="directory">examples</filename> directory to the right location:</para>
-<para><screen><userinput><prompt>$</prompt> <command>cd</command> <filename class="directory">/usr/pkg/etc/dbus-1/system.d/</filename></userinput>
-<userinput><prompt>$</prompt> <command>sudo ln</command> -s \
-<filename>/usr/pkg/share/examples/kde4-dbus/net.sourceforge.smb4k.mounthelper.conf</filename> .</userinput></screen></para></listitem>
-<listitem><para>Edit the file <filename>/usr/pkg/etc/PolicyKit/PolicyKit.conf</filename> and add the following paragraph in the <config version="0.1"> section:</para>
- <programlisting>
- <match action="net.sourceforge.smb4k.mounthelper.*">
- <return result="yes">
- </match></programlisting>
-<para>This will allow everyone to mount and unmount remote Samba shares with &smb4k;.</para></listitem>
-</itemizedlist>
-</sect3>
-</sect2>
+ <para>This will allow everyone to mount and unmount remote Samba shares with &smb4k;.</para></listitem>
+ </itemizedlist>
+ </sect3>
+ </sect2>
</sect1>
</chapter>
More information about the kde-doc-english
mailing list