/usr/share/help/C/mate-user-share/index.docbook is in mate-user-share-common 1.20.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 | <?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>mclasen@redhat.com</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="help:mate-user-guide/feedback" type="help">MATE 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>
|