runtime/doc/userguide/file-sharing.docbook

   1 <sect1 id="file-sharing">
   2
   3 <sect1info>
   4 <authorgroup>
   5 <author>
   6 &Lauri.Watts;
   7 </author>
   8 </authorgroup>
   9 </sect1info>
  10
  11
  12 <title>File Sharing</title>
  13 <sect2 id="file-sharing-kpf">
  14 <title>How to share files with &kpf;</title>
  15
  16 <indexterm><primary>File sharing</primary></indexterm>
  17 <indexterm><primary>Shared Folders</primary></indexterm>
  18
  19 <para>&kpf; provides simple file sharing using &HTTP; (the Hyper Text
  20 Transfer Protocol,) which is the same protocol used by web sites to provide
  21 data to your web browser. &kpf; is strictly a public fileserver, which means
  22 that there are no access restrictions to shared files: whatever you select
  23 for sharing is available to anyone.</para>
  24
  25 <para>&kpf; is designed to be used for sharing files with friends, not to
  26 act like a fully-fledged web server such as
  27 <application>Apache</application>. &kpf; was primarily conceived as an easy
  28 way to share files with others while chatting on <acronym>IRC</acronym>
  29 (Internet Relay Chat, or <quote>chat rooms</quote>.)</para>
  30
  31 <para>&kpf; runs as an applet inside &kicker;. This means that it takes up
  32 little space on your screen and its status is always visible. To start the
  33 &kpf; applet, <mousebutton>right</mousebutton> click on &kicker; and choose
  34 <guimenu>Add Applet to Panel...</guimenu> to open the <guilabel>Add
  35 Applet</guilabel> dialog. Select <guilabel>Public File Server</guilabel> and
  36 click the <guibutton>Add to Panel</guibutton> button.</para>
  37
  38 <para>&kpf; employs the concept of shared folders. You may choose one or
  39 more folders to make public, and all files in that folder (and any
  40 subfolders) will be shared.</para>
  41
  42 <note><para>Please be extremely careful about which folders you share. Remember
  43 that all files in the folder and its subfolders, including
  44 <quote>hidden</quote> files (<quote>dotfiles</quote> to the techies) will be
  45 made available to the world, so be careful not to share sensitive
  46 information, such as passwords, cryptographic keys, your addressbook,
  47 documents private to your organization, &etc;.</para></note>
  48
  49 <para>Once &kpf; is running, you will see a square applet with a thin sunken
  50 bevel and an icon depicting an <guiicon>hot air balloon</guiicon>. The
  51 balloon is visible when no folders are being shared.</para>
  52
  53 <para>To share a folder, <mousebutton>right</mousebutton> click on the
  54 balloon icon and a pop-up menu will appear, containing only one item,
  55 <guimenuitem>New Server...</guimenuitem>. Selecting this entry will cause a
  56 <quote>wizard</quote> to appear, which will ask you a few simple
  57 questions. Completing the questions will set up a folder for sharing.</para>
  58
  59 <para>There is an alternative to using the applet directly when you want to
  60 share a folder. &kpf; is integrated with &konqueror;.</para>
  61
  62 <para>With &konqueror; open and displaying a folder,
  63 <mousebutton>right</mousebutton> click on the background and bring up the
  64 <quote>Properties</quote> dialog.  On install, &kpf; added a
  65 <guilabel>Sharing</guilabel> tab to this dialog. You will be offered the
  66 option of starting &kpf; if it is not running. Choosing
  67 <guibutton>Ok</guibutton> will send a signal to the &kpf; applet, asking it
  68 to add a new share.</para>
  69
  70 <para>For more detailed information, such as how to share different
  71 directories to different people, see the <ulink
  72 url="help:/kpf">&kpf;</ulink> handbook.</para>
  73
  74 </sect2>
  75
  76 <!-- <sect2 id="file-sharing-other-strategies">
  77 <title>Other strategies</title>
  78
  79 Samba, local cgi? nfs devices
  80 -->
  81
  82 <!-- Add links to "further reading" here -->
  83 <!-- <itemizedlist>
  84 <title>Related Information</title>
  85 <listitem><para>to be written</para>
  86 </listitem>
  87 </itemizedlist>
  88
  89
  90 </sect2>-->
  91 </sect1>
  92
  93 <!-- Keep this comment at the end of the file
  94 Local variables:
  95 mode: xml
  96 sgml-omittag:nil
  97 sgml-shorttag:nil
  98 sgml-namecase-general:nil
  99 sgml-general-insert-case:lower
 100 sgml-minimize-attributes:nil
 101 sgml-always-quote-attributes:t
 102 sgml-indent-step:0
 103 sgml-indent-data:true
 104 sgml-parent-document:("index.docbook" "book" "sect1")
 105 sgml-exposed-tags:nil
 106 sgml-local-catalogs:nil
 107 sgml-local-ecat-files:nil
 108 End:
 109 -->