Git commit 782077665cf452a167f45ec88aa26c7d593cd850 by Alexander Reinholdt. Committed on 16/01/2015 at 21:15. Pushed by areinholdt into branch 'master'.
Updated handbook. M +48 -18 doc/index.docbook http://commits.kde.org/smb4k/782077665cf452a167f45ec88aa26c7d593cd850 diff --git a/doc/index.docbook b/doc/index.docbook index 160c043..5f416a4 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -1346,33 +1346,63 @@ </sect2> </sect1> -<!-- Using Smb4K : Remarks for FreeBSD users --> +<!-- Using Smb4K : Special Remarks --> -<sect1 id="freebsd_remarks"> +<sect1 id="special_remarks"> + <title>Special Remarks</title> + +<!-- Using Smb4K : Special Remarks : Remarks for FreeBSD Users --> + +<sect2 id="special_remarks_freebsd"> <title>Remarks for FreeBSD Users</title> -<sect2 id="freebsd_remarks_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> -</sect2> - -<sect2 id="freebsd_remarks_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: +<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: + </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> + </listitem> +</itemizedlist> +</sect3> + +<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> + +<!-- Using Smb4K : Special Remarks : Remarks for NetBSD Users --> + +<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">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> +<para><screen><match action="net.sourceforge.smb4k.mounthelper.*"> + <return result="yes"> +</match></screen></para> +<para>This will allow everyone to mount and unmount remote Samba shares with &smb4k;.</para></listitem> +</itemizedlist> +</sect3> </sect2> </sect1>
