<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY appversion "2.26">
<!ENTITY app "mate-user-share">
]>
<article id="index" lang="ga">
  <articleinfo>
	 <title lang="en">Personal File Sharing Manual</title>
     <copyright lang="en">
       <year>2015-2020</year>
       <holder>MATE Documentation Project</holder>
     </copyright>
	 <copyright lang="en">
		<year>2009</year>
		<holder>Red Hat, Inc.</holder>
     </copyright>

	 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="legal.xml"/>
	 <authorgroup>
           <author role="maintainer" lang="en">
             <firstname>Matthias</firstname>
             <surname>Clasen</surname>
           </author>
	 </authorgroup>

<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
	 <revhistory>
		<revision lang="en">
		  <revnumber>1.0</revnumber>
		  <date>2009</date>
		  <revdescription>
			 <para role="author" lang="en">Matthias Clasen <email>mclasen@redhat.com</email></para>
		  </revdescription>
		</revision>
	 </revhistory>
	 <releaseinfo lang="en">This manual describes version 2.26 of mate-user-share.</releaseinfo>
	 <legalnotice>
		<title lang="en">Feedback</title>
		<para lang="en">To report a bug or make a suggestion regarding the mate-user-share application or this manual, follow the directions in the <ulink url="help:mate-user-guide/feedback" type="help">MATE Feedback Page</ulink>.</para>
	 </legalnotice>
    <abstract role="description">
      <para lang="en">mate-user-share is a session service that enables easy sharing of files
      between several computers.</para>
    </abstract>
  </articleinfo>
  <indexterm lang="en"><primary>mate-user-share</primary></indexterm>
  <indexterm lang="en"><primary>file sharing</primary></indexterm>
  <indexterm lang="en"><primary>sharing</primary></indexterm>

  <sect1 id="mate-user-share-intro">
	 <title lang="en">Introduction</title>
	 <para lang="en">
		mate-user-share is a session service that exports the contents of the <filename>Public</filename> folder in your home directory, so that they can easily be accessed from other computers on the same local network. On the other computers, the shared folder will appear with a name like '<replaceable>user</replaceable>'s shared files' in the <application>caja</application> Network window, where <replaceable>user</replaceable> will be replaced by your user name.
	 </para>
	 <para lang="en">
		mate-user-share uses a WebDAV server to share the <filename>Public</filename> folder, and advertises the share on the local network using mDNS.
	 </para>
         <para lang="en">
		Additionally, mate-user-share can make the shared files available via ObexFTP over Bluetooth, and receive files that are sent to your computer via Bluetooth via ObexPush.
         </para>
  </sect1>

  <sect1 id="mate-user-share-getting-started">
    <title lang="en">Getting started</title>

    <sect2 id="mate-user-share-start">
       <title lang="en">Starting mate-user-share</title>

       <para lang="en">
         The mate-user-share service is normally started by <application>mate-session</application> when you log in. You can change this by opening <menuchoice><guimenu>Preferences</guimenu><guimenu>Startup Applications</guimenu></menuchoice> in the <guimenu>System</guimenu> menu, and modifying the 'User Sharing' entry in the list of startup programs.
       </para>

       <para lang="en">
         To configure various aspects of file sharing, use the File Sharing Preferences, which can be found in the <guimenu>System</guimenu> menu under
         <menuchoice><guimenu>Preferences</guimenu><guimenu>Personal File Sharing</guimenu></menuchoice>.
       </para>
       <figure id="file-sharing-preferences">
         <title lang="en">File Sharing Preferences</title>
         <screenshot>
           <mediaobject>
             <imageobject>
               <imagedata fileref="figures/file-sharing-preferences.png" format="PNG"/>
             </imageobject>
           </mediaobject>
         </screenshot>
       </figure>

     </sect2>
     <sect2 id="mate-user-share-enabling-sharing">
       <title lang="en">Enabling file sharing over the network</title>
       <para lang="en">
         Open the File Sharing Preferences using
         <menuchoice><guimenu>Preferences</guimenu><guimenu>Personal File Sharing</guimenu></menuchoice> in the <guimenu>System</guimenu> menu.
       </para>
       <figure id="sharing-over-the-network">
         <title lang="en">Share Files over the Network</title>
         <screenshot>
           <mediaobject>
             <imageobject>
               <imagedata fileref="figures/sharing-over-the-network.png" format="PNG"/>
             </imageobject>
           </mediaobject>
         </screenshot>
       </figure>
       <para lang="en">
	       To enable file sharing via WebDAV, use the <guilabel>Share public files on network</guilabel> checkbox. When file sharing it enabled, the controls for password protection allow to set a password that needs to be specified before a user on another computer is granted access to the shared files.
	 <note><para lang="en">Some firewall configurations on the local machine might cause problems with the advertisment, as well as the access to the shared files. Consult your system administrator for more details.</para></note>
         <itemizedlist>
           <listitem>
              <para lang="en">
                Select <guilabel>Never</guilabel> to allow everybody to
                freely read or write files in the shared folder.
              </para>
           </listitem>
           <listitem>
              <para lang="en">
                Select <guilabel>Always</guilabel> to require the password
                to read or write files in the shared folder.
              </para>
           </listitem>
           <listitem>
              <para lang="en">
                Select <guilabel>When writing files</guilabel> to allow everybody
                to freely read files in the shared folder, but require the
                password when writing files.
              </para>
           </listitem>
         </itemizedlist>
        <note><para lang="en">When you set a password, you have to give the password to all users that you want to have access to the shared files. Therefore, you should use a password that is different from other passwords you use.</para></note>
       </para>
     </sect2>

     <sect2 id="mate-user-share-enabling-bluetooth">
       <title lang="en">Enabling file sharing over Bluetooth</title>
       <para lang="en">
         Open the File Sharing Preferences using
         <menuchoice><guimenu>Preferences</guimenu><guimenu>Personal File Sharing</guimenu></menuchoice> in the <guimenu>System</guimenu> menu.
       </para>
       <figure id="sharing-over-bluetooth">
         <title lang="en">Share Files over Bluetooth</title>
         <screenshot>
           <mediaobject>
             <imageobject>
               <imagedata fileref="figures/sharing-over-bluetooth.png" format="PNG"/>
             </imageobject>
           </mediaobject>
         </screenshot>
       </figure>
       <para lang="en">
         To enable file sharing via Bluetooth, use the <guilabel>Share public files over Bluetooth</guilabel> checkbox.
         To allow remote Bluetooth devices to delete files in your shared folder, use the <guilabel>Allow remote devices to delete files</guilabel> checkbox.
         To allow remote Bluetooth devices to access your shared files even when they are not bonded with your computer, use the <guilabel>Require remote devices to pair with this computer</guilabel> checkbox.
         <note><para lang="en">When you allow unbonded remote devices to access your shared files, anybody with a Bluetooth-enabled cell phone in the vicinity of your computer can access and perhaps even modify your shared files.
         </para></note>
       </para>
     </sect2>

     <sect2 id="mate-user-share-bluetooth-receiving">
       <title lang="en">Receiving Files over Bluetooth</title>
       <para lang="en">
         Open the File Sharing Preferences using
         <menuchoice><guimenu>Preferences</guimenu><guimenu>Personal File Sharing</guimenu></menuchoice> in the <guimenu>System</guimenu> menu.
       </para>
       <figure id="receiving-over-bluetooth">
         <title lang="en">Receive Files over Bluetooth</title>
         <screenshot>
           <mediaobject>
             <imageobject>
               <imagedata fileref="figures/receiving-over-bluetooth.png" format="PNG"/>
             </imageobject>
           </mediaobject>
         </screenshot>
       </figure>
       <para lang="en">
         To let remote Bluetooth devices send files to your computer, use the <guilabel>Receive files in Downloads folder over Bluetooth</guilabel> checkbox. Received files will be stored in the <filename>Downloads</filename> folder in your home directory. When receiving files is enabled, the <guilabel>Accept files</guilabel> selection allows you to determine which remote devices are allowed to send files.
          <itemizedlist>
            <listitem>
              <para lang="en">
                 Select <guilabel>Always</guilabel> to allow any remote device to send files.
              </para>
            </listitem>
            <listitem>
              <para lang="en">
                  Select <guilabel>Only for Bonded devices</guilabel> to accept files only from bonded devices.
		  <note><para lang="en">Bonded devices are the ones that were connected to your computer, and had to enter a PIN code to connect to or from.</para></note>

	      </para>
            </listitem>
            <listitem>
              <para lang="en">
                  Select <guilabel>Only for Bonded and Trusted devices</guilabel> to accept files only from bonded devices.
		  <note><para lang="en">Devices can be marked as trusted in the <application>bluetooth-properties</application>'s <guilabel>Known devices</guilabel> section.</para></note>
              </para>
            </listitem>
          </itemizedlist>
        </para>
        <para lang="en">
          Use the <guilabel>Notify about received files</guilabel> checkbox to select whether you want to be notified whenever a file is received via Bluetooth.
       </para>
     </sect2>
  </sect1>

</article>
