<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kpf;">
  <!ENTITY package "kdenetwork">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Catalan  "INCLUDE"
> <!-- change language only here -->
]>

<book lang="&language;">

  <bookinfo>

    <title
>El manual de &kpf;</title>

    <authorgroup>

      <author
><firstname
>Rik</firstname
> <surname
>Hemsley</surname
> <affiliation
> <address
><email
>rik@kde.org</email
></address>
        </affiliation>
      </author>

      &traductor.Antoni.Bella; 

    </authorgroup>

    <copyright>
      <year
>2002</year>
      <holder
>Rik Hemsley</holder>
    </copyright>

    <legalnotice
>&FDLNotice;</legalnotice>

    <date
>2003-09-30</date>
    <releaseinfo
>1.0.1</releaseinfo>

    <abstract>
      <para
>&kpf; us permet compartir els fitxers sobre una xarxa. </para>
    </abstract>

    <keywordset>
      <keyword
>KDE</keyword>
      <keyword
>públic</keyword>
      <keyword
>servidor de fitxers</keyword>
      <keyword
>HTTP</keyword>
    </keywordset>

  </bookinfo>

  <chapter id="introduction">

    <title
>Introducció</title>

    <para
>&kpf; proporciona un sistema simple de compartició de fitxers a través d'&HTTP; (protocol de transferència d'hipertext), el qual és el mateix protocol emprat pels servidors web per a enviar les pàgines al vostre navegador. &kpf; és estrictament un servidor de fitxers públic, el qual vol dir que no hi ha restriccions en quant a l'accés als fitxers compartits. Qualsevol cosa que compartiu estarà disponible per a tothom. </para>

    <para
>&kpf; està dissenyat per a compartir fitxers amb els amics, no per a actuar com a un complet servidor web a l'estil de l'<application
>Apache</application
>. &kpf; s'ha concebut de primeres com a un un mètode simple per a compartir fitxers amb d'altres persones mentre es parla pel <acronym
>IRC</acronym
> (xat así­ncron d'Internet, o <quote
>sales de xat</quote
>). </para>

    <para
>Ús tí­pic: &kpf; està configurat per a servir fitxers des de la carpeta <filename class="directory"
>public_html</filename
> en la vostra carpeta d'inici. Des d'aquesta carpeta podreu tenir un fitxer disponible per a algú amb el que esteu parlant en línia. En comptes d'enviar un correu electrònic amb el fitxer adjunt (és possible que no li agradi a tothom aquest mètode), copieu el fitxer a la vostra carpeta <filename class="directory"
>public_html</filename
> i anuncieu que aquest està disponible a http://www.mevamàquina.net:8001/elfitxer </para>

  </chapter>

  <chapter id="using-kpf">

    <title
>Ús de &kpf;</title>

    <sect1 id="kpf-basics">

      <title
>Conceptes bàsics de &kpf;</title>

      <para
>&kpf; runs as an applet inside &kicker;. This means that it takes up little space on your screen and its status is always visible. To start the &kpf; applet, <mousebutton
>right</mousebutton
> click on &kicker; and choose <menuchoice
><guisubmenu
>Add</guisubmenu
> <guisubmenu
>Applet</guisubmenu
><guimenuitem
>Public File Server</guimenuitem
></menuchoice
>. </para>

      <para
>&kpf; utilitza el concepte de carpetes compartides. Podeu fer públics un o més carpetes, amb tots els fitxers i subdirectoris allí continguts. </para>

      <para
>Si us plau, sigueu extremadament acurat amb les carpetes que compartiu. Recordeu que tots els fitxers i subcarpetes de la carpeta compartida, incloguen els fitxers <quote
>ocults</quote
> (els quals el seu nom comença per un punt) estaran disponibles per a tothom, de manera que molta cura amb la informació sensible, com són les contrasenyes, claus de xifrat, la vostra llibreta d'adreces, documents privats de la vostra organització, &etc;. </para>

      <para
>Una vegada &kpf; s'estiga executant, veureu un applet quadrat amb un cartabó enfonsat i una icona amb l'aspecte d'un <guiicon
>globus d'aire calent</guiicon
>. El globus estarà visible quan no s'estiguin compartint carpetes. </para>

      <para
>To share a folder, <mousebutton
>right</mousebutton
> click on the balloon icon and a pop-up menu will appear, containing only one item, <guimenuitem
>New Server...</guimenuitem
>. Selecting this entry will cause a <quote
>wizard</quote
> to appear, which will ask you a few simple questions. Completing the questions will set up a folder for sharing. </para>

      <para
>Hi ha una alternativa a l'ús directe de l'applet per a compartir una carpeta. &kpf; està integrat amb el &konqueror;. </para>

      <para
>Amb el &konqueror; obert i mostrant una carpeta, clic <mousebutton
>dret</mousebutton
> a sobre del fons i opteu pel diàleg de <quote
>Propietats</quote
>. Amb la instal·lació, &kpf; ha afegit una pestanya <guilabel
>Compartició de xarxa local</guilabel
> a aquest diàleg. Si aquest no està en marxa se us oferirà l'opció d'engegar-lo. Escolliu <guibutton
>Bé</guibutton
> i s'enviarà una senyal a l'applet &kpf;, tot seguit us demanarà si afegir un nou recurs compartit. </para>

    </sect1>

  </chapter>

  <chapter id="share-config">

    <title
>Configuració de la compartició</title>

    <sect1 id="listen-port">

      <title
>Escolta en el port</title>

      <para
>Per a cada carpeta compartida pel &kpf; s'obrirà un <quote
>port</quote
>. Aquest <quote
>port</quote
> és simplement el número identificador de servei a la xarxa. Quan algú empra un programa (&pex; un navegador web) per a connectar-se a una màquina, la seva petició és directament encaminada cap al servei especificat per l'adreça, la màquina i el <quote
>port</quote
> del servei que s'executa. </para>

      <para
>The <quote
>port</quote
> concept allows one machine to run more than one network service. Services you might use every day include &HTTP; (the web,) usually connected to by port 80, <acronym
>SMTP</acronym
> (mail sending,) usually on port 25, and POP3 (mail receiving,) usually on port 110. </para>

      <para
>Usualment, quan connecteu amb una xarxa no us caldrà especificar a quin <quote
>port</quote
> voleu connectar. Això és deu a que els ports estan estandarditzats, de manera que al port 80 d'una màquina s'espera trobar-hi un servidor &HTTP; (web). </para>

      <para
>&kpf; no és un servei <quote
>estàndard</quote
>, de manera que escull el port 8001 com a port per omissió. </para>

      <para
>La segona carpeta que compartiu serà oferta escoltant a través del port 8002, incrementant el número cada vegada que oferiu una nova compartició. </para>

      <para
>Dintre de certs límits, sou ben lliure d'escollir qualsevol número d'accés que vulgueu per a un recurs compartit. </para>

      <para
>És habitual que els ports per sota de 1000 estiguin reservats per a serveis del <quote
>sistema</quote
>, &ead;, aquells sota el control de l'administrador de la màquina, pel que és possible que us trobeu que en intentar usar qualsevol port per sota del 1000 aquest simplement no funcioni. </para>

      <para
>&kpf; intentarà advertir-vos de que no es pot <quote
>escoltar</quote
> en un port. Farà això mostrant una icona de <guiicon
>Connexió interrompuda</guiicon
> sobre el racó superior esquerra del gràfic. &kpf; intentarà aturar-vos si assigneu més d'un servidor al mateix port, però no no dirà res si establiu un servidor escoltant en el mateix port que un altre servei, per exemple el vostre servidor web <quote
> real</quote
>. </para>

      <para
>Si veieu la icona <guiicon
>connexió interrompuda</guiicon
>, feu un clic <mousebutton
>dret</mousebutton
> en la gràfica d'ample de banda i trieu <guimenuitem
>Configura...</guimenuitem
>. Ara proveu canviant el port d'escolta i prement <guibutton
>Bé</guibutton
>. Assumint que aquesta vegada heu triat un port lliure, hauríeu de veure desaparèixer la icona de <guiicon
>connexió interrompuda</guiicon
> i hauríeu de poder connectar al servidor. </para>

    </sect1>

    <sect1 id="bandwidth-limit">

      <title
>Limita l'ample de banda</title>

      <para
>El terme <quote
>ample de banda</quote
> es refereix a la quantitat de dades que es poden transmetre per una connexió durant un cert periode de temps. Els tècnics si solen referir com a com de <quote
>gruixuda</quote
> és la <quote
>canonada</quote
>. L'analogia és apta. </para>

      <para
>&kpf; us permet establir un límit sobre quant d'ample de banda serà usat per un servidor en particular. Això resulta d'utilitat quan voleu evitar que la vostra connexió a xarxa es vegi saturada per gent que està realitzant descàrregues des dels vostres servidors. Si esteu emprant un mòdem, per exemple, tan sols disposareu d'uns pocs kilobytes per segon per a vosaltres mateixos. El limitar l'ample de banda emprat pels vostres servidors del &kpf; us permetrà conservar una porció del vostre ample de banda per a ús propi. </para>

      <para
>Tal i com s'ha mencionat, &kpf; mesura l'ample de banda en kilobytes per segon, o kB/seg per abreujar. Un mòdem típic transfereix al voltant de 5 kB/s de promig, de manera que limitant l'ús total de totes les comparticions del &kpf; a un valor menor que aquest, amb prudència, depenent de com estigueu emprant el &kpf;. </para>

    </sect1>

    <sect1 id="follow-symlinks">

      <title
>Segueix els enllaços simbòlics</title>

      <para
>Un enllaç simbòlic és un un fitxer especial el qual és una referència a un altre fitxer (o carpeta) en el vostre sistema de fitxers. Seguint l'enllaç, abastareu al fitxer o carpeta referida - l'enllaç generalment és transparent. </para>

      <para
>Per omissió, un servidor de &kpf; no permet seguir els enllaços simbòlics. Això vol dir que, per exemple, si teniu un servidor apuntant cap a <filename class="directory"
>/home/vos/carpeta/public_html</filename
> i creeu un enllaç a l'interior de <filename class="directory"
>public_html</filename
>, apuntant cap a <filename class="directory"
>/tmp</filename
>, llavors quan algú sol·liciti a <filename class="directory"
>/tmp</filename
> veurà els continguts de la vostra carpeta <filename
>/tmp</filename
>. </para>

      <para
>En general, és una mala idea el permetre seguir els enllaços simbòlics d'aquesta manera. El principal motiu per a permetre-ho és que tingueu enllaços simbòlics a dins de la carpeta compartida, els quals apuntin a un altre lloc a dins de la mateixa carpeta compartida. Això pot resultar-vos d'utilitat si esteu servint tot un <quote
>lloc web</quote
> - el qual, tal i com s'ha mencionat prèviament, no és l'ús intencionat de &kpf;. </para>

      <para
>Just be careful not to link to anywhere on your filesystem that might hold sensitive information (or have a symbolic link in it somewhere that points to sensitive information!) </para>

    </sect1>

  </chapter>

  <chapter id="faq">

    <title
>Preguntes i respostes</title>

    <qandaset id="faq-questions">

      <qandaentry>

        <question>
          <para
>Per què &kpf; no inclou cap mecanisme de seguretat?</para>
        </question>

        <answer>

          <para
>En realitat, &kpf; inclou diversos mecanismes de seguretat designats per a previndre que el mateix usuari accidentalment doni accés a informació sensible. No hi ha protecció per contrasenya ni xifrat. Això és deu al disseny, tal i com s'explicarà. </para>

          <para
>Quantes més mesures de seguretat s'afegeixen a un servei, més segura se sent la gent en emprar-lo. Malauradament, per assegurar una seguretat real, l'usuari ha de tenir un bon enteniment dels assumptes involucrats. Per exemple, el proveir de protecció per contrasenya no té utilitat si el mateix usuari no sap triar una bona contrasenya. Pel que la decisió presa fou proveir de seguretat zero, amb l'esperança de que l'usuari trobi més fàcil d'entendre aquest concepte abans de passar mesos o anys aprenent a sobre de la complexitat de la seguretat a les xarxes. </para>

          <para
>El concepte és simple. Si especifiqueu que una carpeta serà compartida, aquesta serà compartida amb tothom. Si no voleu fer-la disponible a tothom, no caldrà compartir-la. </para>

        </answer>

      </qandaentry>

    </qandaset>

  </chapter>

  <chapter id="credits">

    <title
>Crèdits i llicència</title>

    <para
>&kpf; </para>

    <para
>Program copyright 2002 Rik Hemsley <email
>rik@kde.org</email
> </para>

    <para
>Documentation copyright 2002 by Rik Hemsley <email
>rik@kde.org</email
> </para>
&underFDL; <para
>&kpf; està alliberat sota la llicència del MIT. </para>

  </chapter>

  <appendix id="installation">

    <title
>Instal·lació</title>

    <sect1 id="getting-kpf">

      <title
>Com obtenir &kpf;</title>
&install.intro.documentation; </sect1>

  </appendix>

  &documentation.index; 

</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->

<!-- vim:tabstop=2:shiftwidth=2:expandtab -->
