- <legalnotice id="legalnotice">

- <para>

- Permission is granted to copy, distribute and/or modify this

- document under the terms of the GNU Free Documentation

- License (GFDL), Version 1.1 or any later version published

- by the Free Software Foundation with no Invariant Sections,

- no Front-Cover Texts, and no Back-Cover Texts. You can find

- a copy of the GFDL at this <ulink type="help"

- url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS

- distributed with this manual.

- </para>

- <para> This manual is part of a collection of GNOME manuals

- distributed under the GFDL. If you want to distribute this

- manual separately from the collection, you can do so by

- adding a copy of the license to the manual, as described in

- section 6 of the license.

- </para>

-

- <para>

- Many of the names used by companies to distinguish their

- products and services are claimed as trademarks. Where those

- names appear in any GNOME documentation, and the members of

- the GNOME Documentation Project are made aware of those

- trademarks, then the names are in capital letters or initial

- capital letters.

- </para>

-

- <para>

- DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED

- UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE

- WITH THE FURTHER UNDERSTANDING THAT:

-

- <orderedlist>

- <listitem>

- <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,

- WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR

- IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES

- THAT THE DOCUMENT OR MODIFIED VERSION OF THE

- DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR

- A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE

- RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE

- OF THE DOCUMENT OR MODIFIED VERSION OF THE

- DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR

- MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,

- YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY

- CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY

- SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER

- OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS

- LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED

- VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER

- EXCEPT UNDER THIS DISCLAIMER; AND

- UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL

- THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),

- CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,

- INITIAL WRITER, ANY CONTRIBUTOR, OR ANY

- DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION

- OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH

- PARTIES, BE LIABLE TO ANY PERSON FOR ANY

- DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR

- CONSEQUENTIAL DAMAGES OF ANY CHARACTER

- INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS

- OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR

- MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR

- LOSSES ARISING OUT OF OR RELATING TO USE OF THE

- DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,

- EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF

- THE POSSIBILITY OF SUCH DAMAGES.

- </para>

- </listitem>

- </orderedlist>

- </para>

- </legalnotice>

-

-<?xml version="1.0"?>

-<!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="en">

- <articleinfo>

- <title>Personal File Sharing Manual</title>

- <copyright>

- <year>2009</year>

- <holder>Red Hat, Inc.</holder>

- </copyright>

-

- <xi:include href="legal.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>

- <authorgroup>

- <author role="maintainer">

- <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>

- <revnumber>1.0</revnumber>

- <date>2009</date>

- <revdescription>

- <para role="author">Matthias Clasen <email>[email protected]</email></para>

- </revdescription>

- </revision>

- </revhistory>

- <releaseinfo>This manual describes version &appversion; of &app;.</releaseinfo>

- <legalnotice>

- <title>Feedback</title>

- <para>To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the <ulink url="ghelp:user-guide?feedback-bugs" type="help">GNOME Feedback Page</ulink>.</para>

- </legalnotice>

- <abstract role="description">

- <para>&app; is a session service that enables easy sharing of files

- between several computers.</para>

- </abstract>

- </articleinfo>

- <indexterm><primary>mate-user-share</primary></indexterm>

- <indexterm><primary>file sharing</primary></indexterm>

- <indexterm><primary>sharing</primary></indexterm>

-

- <sect1 id="mate-user-share-intro">

- <title>Introduction</title>

- <para>

- &app; 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>

- &app; uses a WebDAV server to share the <filename>Public</filename> folder, and advertises the share on the local network using mDNS.

- </para>

- <para>

- Additionally, &app; 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>Getting started</title>

-

- <sect2 id="mate-user-share-start">

- <title>Starting &app;</title>

-

- <para>

- The &app; 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>

- 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>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>Enabling file sharing over the network</title>

- <para>

- 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>Share Files over the Network</title>

- <screenshot>

- <mediaobject>

- <imageobject>

- <imagedata fileref="figures/sharing-over-the-network.png" format="PNG"/>

- </imageobject>

- </mediaobject>

- </screenshot>

- </figure>

- <para>

- 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>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>

- Select <guilabel>Never</guilabel> to allow everybody to

- freely read or write files in the shared folder.

- </para>

- </listitem>

- <listitem>

- <para>

- Select <guilabel>Always</guilabel> to require the password

- to read or write files in the shared folder.

- </para>

- </listitem>

- <listitem>

- <para>

- 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>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>Enabling file sharing over Bluetooth</title>

- <para>

- 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>Share Files over Bluetooth</title>

- <screenshot>

- <mediaobject>

- <imageobject>

- <imagedata fileref="figures/sharing-over-bluetooth.png" format="PNG"/>

- </imageobject>

- </mediaobject>

- </screenshot>

- </figure>

- <para>

- 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>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>Receiving Files over Bluetooth</title>

- <para>

- 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>Receive Files over Bluetooth</title>

- <screenshot>

- <mediaobject>

- <imageobject>

- <imagedata fileref="figures/receiving-over-bluetooth.png" format="PNG"/>

- </imageobject>

- </mediaobject>

- </screenshot>

- </figure>

- <para>

- 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>

- Select <guilabel>Always</guilabel> to allow any remote device to send files.

- </para>

- </listitem>

- <listitem>

- <para>

- Select <guilabel>Only for Bonded devices</guilabel> to accept files only from bonded devices.

- <note><para>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>

- Select <guilabel>Only for Bonded and Trusted devices</guilabel> to accept files only from bonded devices.

- <note><para>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>

- 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>