<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&krfb;">
  <!ENTITY package "kdenetwork">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Italian "INCLUDE"
> <!-- ONLY If you are writing non-English 
                                     original documentation, change 
                                     the language here -->
    
  <!-- Do not define any other entities; instead, use the entities
       from entities/general.entities and $LANG/user.entities. -->
]>
<!-- Based on kdoctemplate v0.9 January 10 2003 -->

<book lang="&language;">

<!-- This header contains all of the meta-information for the document such
as Authors, publish date, the abstract, and Keywords -->

<bookinfo>
<title
>Manuale di &krfb;</title>

<authorgroup>
<author
>&Brad.Hards; &Brad.Hards.mail; </author>
</authorgroup>

<othercredit role="translator"
><firstname
>Luciano</firstname
><surname
>Montanaro</surname
><affiliation
><address
><email
>mikelima@cirulla.net</email
></address
></affiliation
><contrib
>Traduzione del manuale</contrib
></othercredit
> 

<copyright>
<year
>2003</year>
<holder
>&Brad.Hards;</holder>
</copyright>
<!-- Translators: put here the copyright notice of the translation -->

<legalnotice
>&FDLNotice;</legalnotice>

<!-- Date and version information of the documentation
Don't forget to include this last date and this last revision number, we
need them for translation coordination !
Please respect the format of the date (YYYY-MM-DD) and of the version
(V.MM.LL), it could be used by automation scripts.
Do NOT change these in the translation. -->

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

<!-- Abstract about this handbook -->

<abstract>
<para
>&krfb; è un applicazione server che permette di condividere la tua sessione con l'utente di un'altra macchina, che può usare un client VNC per vedere o anche controllare il desktop. </para>
</abstract>

<!-- This is a set of Keywords for indexing by search engines.
Please at least include KDE, the KDE package it is in, the name
 of your application, and a few relevant keywords. -->

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdenetwork</keyword>
<keyword
>krfb</keyword>
<keyword
>VNC</keyword>
<keyword
>RFB</keyword>
<keyword
>krdc</keyword>
<keyword
>Condividere il desktop</keyword>
<keyword
>Controllo remoto</keyword>
<keyword
>Assistenza remota</keyword>
<keyword
>Desktop remoto</keyword>
</keywordset>

</bookinfo>

<!-- The contents of the documentation begin here.  Label
each chapter so with the id attribute. This is necessary for two reasons: it
allows you to easily reference the chapter from other chapters of your
document, and if there is no ID, the name of the generated HTML files will vary
from time to time making it hard to manage for maintainers and for the CVS
system. Any chapter labelled (OPTIONAL) may be left out at the author's
discretion. Other chapters should not be left out in order to maintain a
consistent documentation style across all KDE apps. -->

<chapter id="introduction">
<title
>Introduzione</title>

<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract.  Don't include a
revision history. (see installation appendix comment) -->

<para
>&krfb; è un applicazione server che permette di condividere la tua sessione con l'utente di un'altra macchina, che può usare un client VNC per vedere o anche controllare il desktop. </para>

<para
>Tipicamente, userai &krfb; con il client VNC di &kde;, che è &krdc;, che è adattato specificamente alle caratteristiche peculiari di &krfb;. </para>

<para
>&krfb; non richiede che tu faccia partire una nuova sessione X - può condividere quella corrente. Questo è molto utile se vuoi che qualcuno ti aiuti a portare a termine un compito. </para>

<para
>Segnala eventuali problemi o suggerimenti per migliorare questo programma sulla mailing list di &kde;, oppure inoltra la segnalazione di un bug a <ulink url="http://bugs.kde.org"
>http://www.bugs.kde.org</ulink
>. </para>
</chapter>

<chapter id="what-is-RFB">
<title
>Il protocollo Remote Frame Buffer</title>

<para
>Questo capitolo fornisce una breve introduzione al protocollo Remote Frame Buffer che è usato da &krfb; e da altri sistemi compatibili. Se hai già dimestichezza con RFB puoi procedere al capitolo successivo. </para>

<para
>L'implementazione ad alto livello di un sistema che usa il protocollo Remote Frame Buffer è noto come Virtual Network Computer, o più spesso semplicemente come <acronym
>VNC</acronym
>. </para>

<para
>Remote Frame Buffer (per brevità, <acronym
>RFB</acronym
>) è un semplice protocollo per l'accesso remoto alle interfacce utente. Funziona al livello della memoria di quadro, che corrisponde grossomodo all'immagine mostrata sullo schermo, il che significa che può essere usato con tutti i sistemi a finestre (inclusi X11, &MacOS; e &Microsoft; &Windows;). Le applicazioni per gestire il protocollo RFB esistono per molte piattaforme, e spesso possono essere liberamente ridistribuite. </para>

<para
>Nel protocollo <acronym
>RFB</acronym
>, l'applicazione in esecuzione sulla macchina davanti a cui è seduto l'utente (dove si trovano schermo, tastiera e mouse) si chiama il client. L'applicazione che è eseguita sul computer dove si trova il frame buffer (che esegue il sistema a finestre e l'applicazione che l'utente controlla da remoto) si chiama il server. &krfb; è il server di &kde; per il protocollo Remote Frame Buffer. &krdc; è il client di &kde; per il protocollo <acronym
>RFB</acronym
>. </para>

<para
>L'invio di un'immagine della memoria di quadro richiede una quantità di traffico ragionevolmente alta, per cui il protocollo RemoteFrame Buffer funziona al meglio sui collegamenti a banda larga, come una LAN. È possibile usare &krfb; su altri tipi di connessioni, ma le prestazioni non saranno altrettanto buone. </para>

</chapter>

<chapter id="using-krfb">
<title
>Uso di &krfb;</title>

<!-- This chapter should tell the user how to use your app. You should use as
many sections (Chapter, Sect1, Sect3, etc...) as is necessary to fully document
your application. -->

<para
>È molto semplice usare &krfb; - ha un'interfaccia semplice, come dimostra la schermata che segue. </para>

<para>
<screenshot>
<screeninfo
>Ecco un'istantanea di &krfb;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="screenshot.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>La finestra principale di &krfb;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Quando vuoi permettere a qualcuno di accedere al tuo desktop, puoi creare un invito personale usando il pulsante <guibutton
>Crea invito personale...</guibutton
>, che farà apparire una finestra contenente le informazioni necessarie per l'accesso al desktop. Un esempio è riportato qui sotto. </para>

<para>
<screenshot>
<screeninfo
>Esempio di invito personale di &krfb;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="personal_invitation.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="personal_invitation.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Esempio di invito personale di &krfb;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Per aumentare la sicurezza, l'invito è valido solo per un'ora dopo la sua creazione, e naturalmente la persona che si connette deve inserire una password corretta. </para>

<para
>Poiché è probabile che tu voglia invitare qualcuno ad accedere al tuo desktop per posta elettronica, &krfb; permette di creare inviti come messaggi di posta elettronica. Puoi creare questo tipo di inviti usando il pulsante <guibutton
>Invita tramite posta elettronica</guibutton
> della finestra principale di &krfb;. Questo di solito farà apparire un messaggio di posta elettronica dall'aspetto seguente, pronto per essere completato con l'indirizzo della persona a cui stai per mandare l'invito. </para>

<para>
<screenshot>
<screeninfo
>Esempio di invito via posta elettronica di &krfb;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="email_invitation.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="email_invitation.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Esempio di invito via posta elettronica di &krfb;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<warning>
<para
>&krfb; ti avvertirà su quali implicazioni l'invio di queste informazioni su un canale non sicuro avrà sulla sicurezza. Dovresti dare ascolto a questi avvertimenti. </para>
<para
>Se non puoi cifrare il messaggio (o rendere sicuro il collegamento in altro modo), inviare l'invito per posta è un rischio molto alto per la sicurezza, perché, potenzialmente, chiunque può leggere la password e l'indirizzo dal messaggio mentre attraversa la rete e prendere il controllo della tua macchina. </para>
<para
>Se non puoi cifrare il messaggio di posta, è preferibile usare un invito faccia a faccia, o telefonare alla persona a cui stai per dare l'accesso, verificarne l'identità e fornire le informazioni necessarie per l'accesso in tal modo. </para>
</warning>

<sect1 id="krfb-managing-invitations">
<title
>Gestione degli inviti di &krfb;</title>

<para
>Dopo aver creato l'invito (che si tratti di un invito personale o di uno inviato attraverso la posta elettronica), &krfb; permette di gestire gli inviti. La finestra che fornisce il controllo è attivabile premendo il pulsante <guibutton
>Gestisci inviti...</guibutton
> della finestra principale. L'attivazione farà comparire la finestra mostrata qui sotto. </para>

<para>
<screenshot>
<screeninfo
>Gestione degli inviti di &krfb;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="invitation_management.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="invitation_management.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Gestione degli inviti di &krfb;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>La finestra di gestione degli inviti permette di creare più inviti (usando i pulsanti <guibutton
>Nuovo invito personale...</guibutton
> e <guibutton
>Nuovo invito tramite posta elettronica...</guibutton
>, che hanno lo stesso effetto dei pulsanti <guibutton
>Crea invito personale...</guibutton
> e <guibutton
>Invita tramite posta elettronica...</guibutton
> della finestra principale di &krfb;. </para>

<para
>La finestra di gestione degli inviti permette anche di eliminare gli inviti esistenti. Per eliminare solo uno degli inviti, selezionalo col mouse o premendo il tasto <keycap
>Tab</keycap
> sulla tastiera fino a che l'invito non viene selezionato, e poi premi il pulsante <guibutton
>Elimina</guibutton
>. Per eliminare tutti gli inviti basta selezionare il pulsante <guibutton
>Elimina tutti</guibutton
>. </para>

<!-- OK, so this is obvious, I only did it for completeness -->
<para
>La selezione di <guibutton
>Chiudi</guibutton
> chiude la finestra di dialogo. </para>

</sect1>

<sect1 id="krfb-configuration">
<title
>Configurazione di &krfb;</title>
<para
>In aggiunta all'interfaccia principale di &krfb; mostrata e descritta precedentemente, puoi anche controllare &krfb; con il suo modulo di controllo, che può essere raggiunto dal centro di controllo di &kde;, ed anche premendo il pulsante <guibutton
>Configura...</guibutton
> nella finestra principale di &krfb;. La configurazione di &krfb; è controllata attraverso una finestra a schede multiple, come mostra la schermata seguente: </para>

<para>
<screenshot>
<screeninfo
>Configurazione di &krfb; (scheda Accesso)</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="configuration_access.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="configuration_access.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Configurazione di &krfb; (scheda Accesso)</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>La scheda <guilabel
>Accesso</guilabel
> permette di configurare le impostazioni relative all'accesso al server &krfb;. </para>

<para
>Il pulsante <guibutton
>Crea e gestisci gli inviti...</guibutton
> ti porta alla <link linkend="krfb-managing-invitations"
>finestra di gestione degli inviti di &krfb;</link
> che è stata già descritta. </para>

<para
>La casella <guilabel
>Annuncia servizio sulla rete</guilabel
> controlla se &krfb; annuncia gli inviti in rete attraverso <acronym
>SLP</acronym
>. Questo di solito è una buona idea, ma funziona veramente bene solo con i client che sfruttano il protocollo di localizzazione dei servizi, come &krdc;. </para>

<para
>La casella <guilabel
>Permetti connessioni non invitate</guilabel
> permette di decidere se &krfb; debba permettere la connessione in assenza di invito. Se le connessioni senza invito sono permesse, è buona norma specificare una password per la protezione dell'accesso. Puoi anche usare le caselle sottostanti per scegliere se devi confermare l'accettazione della connessione prima che questa possa procedere, e se la persona connessa ha il controllo del desktop, o se può solo guardare. </para>

<para
>Se la macchina è una stazione di lavoro, e scegli di usare le connessioni senza inviti, probabilmente vorrai selezionare anche <guilabel
>Conferma connessioni senza invito prima di accettarle</guilabel
>. Se invece la macchina è un server e vuoi usare &krfb; per l'amministrazione remota, vorrai tenere deselezionata la casella <guilabel
>Conferma connessioni senza invito prima di accettarle</guilabel
>. </para>

<note>
<para
>&krfb; usa il sistema di password normale per <acronym
>RFB</acronym
>, che non trasferisce la password in chiaro attraverso la rete, ed usa invece un sistema a domanda e risposta. Questo è ragionevolmente sicuro, a patto che la password sia conservata in modo sicuro. </para>
</note>

<para
>&krfb; permette anche di decidere se l'immagine di sfondo debba essere inoltrata al client oppure no. Puoi scegliere che cosa fare dalla scheda <guilabel
>Sessione</guilabel
> come mostrato di seguito. </para>

<para>
<screenshot>
<screeninfo
>Configurazione di &krfb; (scheda Sessione)</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="configuration_session.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="configuration_session.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Configurazione di &krfb; (scheda Sessione)</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Se marchi la casella, &krfb; non trasferirà l'immagine di sfondo. Se la lasci in bianco, sarà il client a decidere se l'immagine di sfondo verrà trasferita oppure no. </para>

<para
>La scheda <guilabel
>Rete</guilabel
> permette di decidere la porta che &krfb; deve usare, come mostrato di seguito. </para>

<para>
<screenshot>
<screeninfo
>Configurazione di &krfb; (scheda Rete)</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="configuration_network.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="configuration_network.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Configurazione di &krfb; (scheda Rete)</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Se selezioni <guilabel
>Assegna porta automaticamente</guilabel
>, &krfb; localizzerà una porta adatta, e gli inviti che verranno emessi specificheranno l'uso di tale porta. Se deselezioni la casella <guilabel
>Assegna porta automaticamente</guilabel
>, potrai specificare una porta particolare. Questo può essere utile se usi l'inoltro delle porte nel firewall. Nota che se l'<acronym
>SLP</acronym
> (il protocollo del servizio di localizzazione) è attivo, si occuperà automaticamente dell'identificazione della porta corretta. </para>

</sect1>

<sect1 id="krfb-connection">
<title
>Che cosa succede quando qualcuno si connette a &krfb;</title>

<para
>Quando qualcuno si connette a &krfb; sulla tua macchina, apparirà una finestra di notifica assomigliante alla schermata seguente, a meno che non tu non abbia scelto di accettare connessioni senza inviti e senza avvertimenti. </para>
<para>
<screenshot>
<screeninfo
>La finestra di connessione di &krfb;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="connection.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="connection.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>La finestra di connessione di &krfb;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Se premi il pulsante <guibutton
>Accetta connessione</guibutton
>, il client potrà procedere all'autenticazione (che richiede la password corretta per un invito personale o per un invito via posta elettronica). Se premi <guibutton
>Rifiuta connessione</guibutton
> il tentativo di connessione verrà bloccato. </para>

<para
>La casella <guilabel
>Permetti agli utenti remoti di controllare tastiera e mouse</guilabel
> determina se il client può solo osservare, o può prendere il controllo della macchina. </para>

<para
>Se la connessione del client ha successo, ed ha usato la password di un invito personale o di un invito tramite posta elettronica, l'invito è eliminato, e non può essere usato di nuovo. Apparirà anche una finestrella a comparsa vicino al vassoio, per informarti che la connessione è stata fatta. </para>

</sect1>
</chapter>

<chapter id="dcop">
<title
>Guida per lo sviluppatore di &krfb;</title>

<para
>&krfb; gestisce un piccolo numero di comandi &DCOP;, che sono descritti in questo capitolo. Se &DCOP; non ti è familiare, non è indispensabile la lettura di questo capitolo. Però se ti piacerebbe automatizzare alcune delle azioni di &krfb; (o di altre applicazioni di &kde;), &DCOP; è uno strumento molto utile. È possibile scoprire molte cose su &DCOP; sfogliando la documentazione in rete e le sessioni di autoapprendimento disponibili presso <ulink url="http://developer.kde.org"
>http://developer.kde.org</ulink
>. </para>

<para
>Puoi far terminare l'applicazione &krfb; usando il comando quit, come mostrato in questo esempio: </para>

<informalexample>
<screen
><prompt
>&percnt;</prompt
>dcop krfb-1507 MainApplication-Interface quit
</screen>
</informalexample>

<note>
<para
>Sarà necessario cambiare il <userinput
>krfb-1507</userinput
> dell'esempio in modo che corrisponda all'istanza di &krfb; che vuoi effettivamente spegnere. Se esegui <command
>dcop</command
> senza opzioni, otterrai la lista delle applicazioni in esecuzione che &DCOP; può controllare. </para>
</note>

</chapter>

<chapter id="faq">
<title
>Domande e risposte</title>
<para
>&reporting.bugs; &updating.documentation;</para
> </chapter>

<chapter id="credits">

<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->

<title
>Riconoscimenti e licenza</title>

<para
>&krfb; </para>
<para
>Il programma è copyright 2002 Tim Jansen <email
>tim@tjansen.de</email
> </para>
<para
>Contributi: <itemizedlist
> <listitem
><para
>Ian Reinhart Geiser <email
>geiseri@kde.org</email
></para>
</listitem>
</itemizedlist>
</para>

<para
>La documentazione è copyright &copy; 2003 &Brad.Hards; &Brad.Hards.mail; </para>

<para
>Traduzione di Luciano Montanaro <email
>mikelima@cirulla.net</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installazione</title>

<sect1 id="getting-krfb">
<title
>Dove trovare &krfb;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Compilazione ed installazione</title>
&install.compile.documentation; </sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

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