<?xml version="1.0" encoding="iso-8859-15"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
     "http://docbook.org/xml/4.2/docbookx.dtd" []>

<article lang="it">

  <articleinfo>

    <!-- Use "HOWTO", "mini HOWTO", "FAQ" in title, if appropriate -->
    <title>Autodir HOWTO</title>
    <author>
       <firstname>Venkata Ramana</firstname>
       <surname>Enaganti</surname>
       <affiliation>
          <!-- Valid email...spamblock/scramble if so desired -->
          <address><email>ramana &lt;&gt; intraperson dot com</email></address>
       </affiliation>
     </author>

     <!-- All dates specified in ISO "YYYY-MM-DD" format -->
     <pubdate>23-9-2004</pubdate>

     <!-- Most recent revision goes at the top; list in descending order -->
     <revhistory>
       <revision>
	  <revnumber>1.04</revnumber>
	  <date>25-5-2007</date>
	  <authorinitials>VRE</authorinitials>
	  <revremark>Piccoli aggiornamenti</revremark>
       </revision>
       <revision>
       	  <revnumber>1.03</revnumber>
	  <date>15-9-2006</date>
	  <authorinitials>GaMA</authorinitials>
	  <revremark>Revisione richiesta dall'autore.</revremark>
	</revision>
       <revision>
          <revnumber>1.02</revnumber>
          <date>25-12-2004</date>
          <authorinitials>VRE</authorinitials>
          <revremark>Piccoli aggiornamenti</revremark>
       </revision>
       <revision>
          <revnumber>1.00</revnumber>
          <date>23-9-2004</date>
          <authorinitials>VRE</authorinitials>
          <revremark>Prima versione, rivista da Rahul Sundaram di TLDP</revremark>
       </revision>
       <revision>
          <revnumber>0.32</revnumber>
          <date>13-9-2004</date>
          <authorinitials>VRE</authorinitials>
          <revremark>Nuove sezioni come i requisiti ed altro.</revremark>
       </revision>
       <revision>
          <revnumber>0.10</revnumber>
          <date>24-6-2004</date>
          <authorinitials>VRE</authorinitials>
          <revremark>seconda bozza</revremark>
       </revision>
       <revision>
          <revnumber>0.9</revnumber>
          <date>11-6-2004</date>
          <authorinitials>VRE</authorinitials>
          <revremark>Prima bozza</revremark>
       </revision>
     </revhistory>

     <!-- Provide a good abstract; a couple of sentences is sufficient -->
     <abstract>
        <para>Questo HOWTO &egrave; dedicato all'installazione e configurazione
	di <emphasis role="bold">Autodir</emphasis>, e ad altre problematiche
        inerenti  <emphasis role="bold">Autodir</emphasis>.<emphasis
        role="bold">Autodir</emphasis> &egrave; spesso utilizzato per permettere
        un facile accesso alle directory home. Traduzione a cura di
	Gualtiero Testa (gualty at libero.it). Revisione a cura di Elisabetta
        Galli (lab at kkk.it)</para>
     </abstract>

  </articleinfo>


<!-- Content follows...include introduction, license information, feedback -->

<sect1 id="intro">
<title>Introduzione</title>

<para><emphasis role="bold">Autodir</emphasis> offre un metodo semplice ed
efficace per creare, in maniera trasparente, directory come le directory home.
Autodir si appoggia al protocollo <ulink
url="htp://www.autofs.org">autofs</ulink> per il suo funzionamento.</para>

<para>Questo documento spiega come creare directory su richiesta usando
<emphasis role="bold">Autodir</emphasis> in maniera trasparente alle
applicazioni. Il documento spiega inoltre il sistema di backup trasparente che
&egrave; possibile con <emphasis role="bold">Autodir</emphasis>, senza una
interruzione per backup del sistema; questa soluzione si applica a tutte le
directory gestite da <emphasis role="bold">Autodir</emphasis>.</para>

  <!-- Legal Sections -->
  <sect2 id="copyright">
    <title>Licenza e Copyright</title>
    <!-- The LDP recommends, but doesn't require, the GFDL --> 
    <para>
     This document, <emphasis>Autodir HOWTO</emphasis>,
     is copyrighted (c) 2004 by <emphasis>Venkata Ramana Enaganti</emphasis>.

This work is licensed under the Creative Commons Attribution License. To view a
copy of this license, visit <ulink
url="http://creativecommons.org/licenses/by/2.0">http://creativecommons.org/
licenses/by/2.0/</ulink> or send a letter to Creative Commons, 559 Nathan Abbott
Way, Stanford, California 94305, USA.

    </para>

    <para>
     Linux is a registered trademark of Linus Torvalds.
    </para>
  </sect2>

  <sect2 id="disclaimer">
    <title>Liberatoria</title>

    <para>L'autore non si assume alcuna responsabilit&agrave; per il contenuto di questo documento. Usare i concetti, gli esempi e le informazioni a proprio rischio e pericolo. Ci possono essere errori ed imprecisioni che potrebbero danneggiare il sistema. Procedere con cautela e, sebbene un danno sia altamente improbabile, l'autore non si assume alcuna responsabilit&agrave;.</para>

    <para>Tutti i marchi registrati appartengono ai rispettivi proprietari, a meno che non sia indicato diversamente. L'uso di un termine in questo documento non deve essere considerata violazione della validit&agrave; del marchio. La citazione di specifici prodotti o marchi non deve essere considerata come approvazione.</para>
  </sect2>

  <!-- Feedback -->
  <sect2 id="feedback">
    <title>Commenti</title>

    <para>Commenti su questo documento sono sicuramente benvenuti. Inviare aggiunte, commenti e critiche al seguente indirizzo di email:<email>ramana &lt;&gt; intraperson dot com</email>.
    </para>
  </sect2>
  <sect2>
    <title>Nuove versioni di questo documento</title>
	<para>L'ultima versione di questo HOWTO &egrave; disponibile su <ulink url="http://www.intraperson.com/autodir/">http://www.intraperson.com/autodir/</ulink>.</para>
  </sect2>
  <sect2 id="credits">
    <title>Crediti / contributi</title>
                                                                                                 
    <para>In questo documento, ho il piacere di evidenziare per la revisione tecnica e linguistica:</para>
                                                                                                 
    <!-- Please scramble addresses; help prevent spam/email harvesting -->
    <itemizedlist>
      <listitem>
        <para>Rahul Sundaram<email>rahulsundaram@yahoo.co.in</email></para>
      </listitem>
      <listitem>
        <para>Machtelt Garrels</para>
      </listitem>
    </itemizedlist>
  </sect2>


</sect1>

<!-- 

     The rest of the document follows. This is where your
     subject-specific content goes. A logical reading
     progression should be present - installation, setup,
     configuration, using, advanced topics, etc.

-->


<!-- Other Sections of Interest... -->

<sect1>
	<title>Prima di entrare nei dettagli...</title>

<para>Dopo aver rilasciato la versione beta di intraperson, ho iniziato a
lavorare sulla guida di amministrazione che tratta gli aspetti di
amministrazione di <emphasis role="bold">intraPerson</emphasis>. Per maggiori
dettagli controllare su <ulink url="http://www.intraperson.com"/>. Ma sono stato
bloccato da una semplice cosa. E' facile creare utenti in LDAP, o almeno lo
penso io, ma come creare le directory home per quegli utenti in LDAP
indipendentemente da dove gli account sono importati ?</para>

<para>Ho trovato alcune soluzioni ma non sono soddisfatto perch&eacute; ognuna
aveva dei seri inconvenienti. Dopo aver sfogliato la documentazione di Autofs e
aver fatto un po' di prove, sono arrivato alla conclusione che il protocollo
Autofs pu&ograve; offrire una soluzione migliore a questa sfida.</para>

<para>Il risultato &egrave; <emphasis role="bold">Autodir</emphasis>, basato
sul protocollo Autofs.</para>

</sect1>

<sect1>
<title>Perch&eacute; non il pam_mkhomedir?</title>
<para>Il modulo PAM <literal>pam_mkhomedir</literal> utilizza l'architettura
Pluggable Authentication Module per questa operazione. Cos&igrave; com'&egrave;,
ci sono delle limitazioni. Per esempio:</para>

<itemizedlist>
<listitem><para>Alcuni server potrebbero non autenticare gli utenti ma
aspettarsi che le loro directory esistano. Questo significa che non utilizzano
PAM e, a sua volta, che <literal>pam_mkhomedir</literal> non ha la
possibilit&agrave; di creare le directory home. L'esempio pi&ugrave; tipico
&egrave; quello dei server di posta.</para></listitem>

<listitem><para>PAM &egrave; sempre un componente opzionale per
l'autenticazione. Alcuni servizi potrebbero non usare PAM ed utilizzare un
diverso metodo di autenticazione degli utenti. In questo caso
<literal>pam_mkhomedir</literal> non sar&agrave; mai usato.</para></listitem>
<!-- FIXME: example? -->
<listitem><para>In genere <filename>/home</filename> &egrave; controllata da
root e solo gli utenti root possono creare directory home al suo interno. Dunque
il servizio che vuole creare directory home con PAM deve essere eseguito come
root oppure la directory home deve avere gli stessi permessi come, per esempio,
<filename>/tmp</filename>.</para></listitem>
</itemizedlist>

<para>Infine <emphasis role="bold">Autodir</emphasis> ha un utilizzo pi&ugrave;
ampio e supporta funzionalit&agrave; pi&ugrave; interessanti.</para>

</sect1>

<sect1>
	<title>Dove pu&ograve; essere usato Autodir ?</title>

<itemizedlist>
<listitem><para>Dove gli account utente risiedono in un database centralizzato
come LDAP, SQL, NIS, NIS+ o altri database, dai quali utenti e gruppi sono
importati su altri sistemi. Per creare, ad esempio in home, directory di gruppi
su quei sistemi che importano gli account da un database centralizzato, su
richiesta.</para></listitem>

<listitem><para>Per sfruttare la sua funzionalit&agrave; di backup trasparente
per i sistemi in linea 24 ore su 24.</para></listitem>

<listitem><para>Pu&ograve; anche essere utilizzato quando gli account sono sul
sistema locale, nascondendo per certi versi quali account esistono nella
directory <filename>/home</filename>, per esempio.</para></listitem>

</itemizedlist>

</sect1>

<sect1>
	<title>Cosa non &egrave; Autodir</title>

<para><emphasis role="bold">Autodir</emphasis> pu&ograve; creare directory ma
non pu&ograve; rimuoverle quando gli utenti e/o gruppi sono rimossi dal database
di account. Per farlo utilizzare script di cron personalizzati.</para>
<!-- FIXME: this would be a good place to use xref for crosslinks.-->

</sect1>

<sect1>
	<title>Differenze tra Autodir e Autofs</title>

<para>Potrebbero esserci problemi nel caso si utilizzi gi&agrave; il pacchetto
<application>Autofs</application>  per gestire il montaggio delle directory
home. Analizziamo le differenze tra i due pacchetti:</para>

<itemizedlist>
<listitem>
<para>L'obiettivo principale di autofs &egrave; quello di gestire montaggi di
rete a richiesta invece di montarli tutti allo stesso tempo, il che preserva le
risorse di sistema. Sebbene ci sia, nel pacchetto autofs, un supporto per il
montaggio dinamico di directory home, il requisito &egrave; che <emphasis>queste
directory home esistano gi&agrave;</emphasis>.</para>

<para>D'altro lato, <emphasis role="bold">Autodir</emphasis> &egrave;
specializzato <emphasis>solo</emphasis> nella creazione e montaggio di directory
locali.</para>

<para><emphasis role="bold">Autodir</emphasis> pu&ograve; anche creare
directory reali su file system su disco le quali non risiedono in una singola
directory base. Questo &egrave; quello che fanno per impostazione predefinita
utility come <command>useradd</command>. In un file system standard, tutte le
directory home risiedono nella directory base <filename>/home</filename>. Per
file system come ext2 e ext3, le prestazioni degradano se un numero elevato di
directory home esiste in una singola directory base.</para>

<para>Per le applicazioni che accedono a queste directory, <emphasis
role="bold">Autodir</emphasis> le presenta <emphasis>su richiesta</emphasis> in
una <emphasis>singola</emphasis> directory base virtuale; le effettive directory
sono create in sottodirectory in qualche altra directory con approccio
gerarchico.</para>

<para>Per esempio, la home reale per l'utente di nome <literal>user1</literal>
sar&agrave; creata in <filename>/autohome/u/us/user1</filename> se configurata
in questo modo, ma montata in <filename>/home</filename> su richiesta delle
applicazioni che accedono alla directory home come 
<filename>/home/user1</filename>.</para>

<!-- changed uid into username, as uid is numercial and username [a-z]. -->

<para>Le autorizzazioni per la directory base reale, dove le directory home
sono effettivamente create (<filename>/autohome</filename> nell'esempio sopra),
sono gestite in modo che solo root possa accedere a
<filename>/autohome</filename>.</para>

<para>Il montaggio delle directory su richiesta, e lo smontaggio quando non
pi&ugrave; in uso, porta ad una interessante opportunit&agrave;: poter dire
quando una directory &egrave; in uso o no. Se la directory non &egrave; in uso,
si pu&ograve; far partire senza pericoli un programma come una applicazione di
backup, quando una directory non &egrave; montata.</para>

<para><emphasis role="bold">Autodir</emphasis> sfrutta questa
possibilit&agrave; facendo partire il menzionato comando di backup quando una
directory diventa inutilizzata.</para>
</listitem>

<listitem>
<para>C'&egrave; una ulteriore questione da illustrare per gli amministratori
che leggono questo documento. <emphasis role="bold">Autodir</emphasis> non
chiama i programmi esterni <command>mount</command> e <command>umount</command>,
come nel caso del pacchetto autofs; usa invece direttamente chiamate di sistema.
Come effetto secondario, Autodir &egrave; pi&ugrave; veloce ed affidabile ma il
file <filename>mtab</filename> non viene aggiornato. Ho ritenuto che non fosse
necessario perch&eacute; tutti i montaggio e smontaggi sono effettuati su
directory locali.</para>
</listitem>

<listitem>
<para>Un'altra piccola differenza &egrave; che <emphasis
role="bold">Autodir</emphasis> &egrave; completamente
<emphasis>multi-threaded</emphasis>. Anche autofs diventer&agrave;
multi-threaded nelle versioni future.</para>
</listitem>
</itemizedlist>


</sect1>

<sect1>
<title>Il funzionamento</title>

<para><emphasis role="bold">Autodir</emphasis> utilizza i moduli per aggiungere
funzionalit&agrave; specifiche. <emphasis role="bold">Autodir</emphasis>
implementa funzionalit&agrave; generiche che i moduli sfruttano e su cui
aggiungono funzioni specifiche.</para>

<para>Si pu&ograve; aggiungere solo un modulo alla volta a  <emphasis
role="bold">Autodir</emphasis>. Se ci sono due moduli, ad esempio
<literal>autohome</literal> e <literal>autogroup</literal>, allora occorre
creare due processi di <emphasis role="bold">Autodir</emphasis> in modo che ogni
processo abbia un solo modulo agganciato.</para>

<para>Per le successive spiegazioni, utilizzer&ograve; il modulo
<literal>autohome</literal> che gestisce in maniera trasparente la creazione
delle directory home.</para>


<note><title>Presupposti</title>
<!--FIXME: notes also take the title attribute, this sets them apart from the
rest of the text in a nicer way, especially with the LDP stylesheets.-->
<itemizedlist>

<listitem><para>Il modulo <literal>autohome</literal> crea le directory home
degli utenti su richiesta se queste non esistono gi&agrave;.</para></listitem>

<listitem><para>Si assume che gli account utenti esistano ma non le relative
directory home, o perch&eacute; questi account sono stati creati con l'opzione
<literal>-M</literal> di <command>useradd</command> o perch&eacute; sono stati
importati da LDAP, NIS o altri database esterni per i quali le directory home
devono essere ancora create.</para></listitem>

<listitem><para>Si assume anche, <emphasis>ma solo per questa
spiegazione</emphasis>, che tutte le directory home degli utenti debbano essere
nella directory <filename>/home</filename>.</para></listitem>

</itemizedlist>
</note>

<note><title>KISS</title>
<para>Keep it Simple: alcuni dettagli di fino sono stati intenzionalmente
tralasciati per rendere la spiegazione facile da capire.</para></note>

<para>Prima di tutto il file system autofs &egrave; montato sulla directory
<filename>/home</filename> da <emphasis role="bold">Autodir</emphasis>. Il
kernel di Linux viene informato che <filename>/home</filename> &egrave; gestita
d'ora in avanti da una applicazione in user space, <emphasis
role="bold">Autodir</emphasis>.</para>

<note><title>Autofs ?</title>
<para>Non ci si deve preoccupare troppo del file system autofs se non lo si
capisce. E' sufficiente considerarlo un file system speciale, simile ai file
system in memoria ma con alcune propriet&agrave; speciali.</para></note>

<screen>

                                +----------------+
                                |  Linux Kernel  |
                                +----------------+
                                  /        \
                                 /          \
                                /            \
                               /              \
   +-------------+       +--------+       +------------+        +-----------------++-------------+       +--------+       +------------+        +-----------------+
   | Application |------&gt;| /home  |&lt;-----&gt;|  Autodir   |&lt;------&gt;| autohome module |
   +-------------+       +--------+       +------------+        +-----------------++-------------+       +--------+       +------------+        +-----------------+
                              \                                          /
                               \  +----------------+                    /
                                +-|   /autohome    |&lt;------------------+
                                  +----------------+
</screen>

<para>Quando una applicazione o un demone richiede l'accesso alla directory
home di un utente, per esempio <filename>/home/userhome1</filename>, entrano
direttamente in  <filename>/home/userhome1</filename> per accedervi. Il kernel
rileva l'accesso ed informa <emphasis role="bold">Autodir</emphasis> se la
directory <filename>userhome1</filename> non esiste ancora in
<filename>/home</filename>.</para>

<para><emphasis role="bold">Autodir</emphasis>, a sua volta, passa questa
richiesta al modulo <literal>autohome</literal>. Il modulo
<literal>autohome</literal> non tocca la directory <filename>/home</filename>.
Invece gestisce le <emphasis>vere directory home</emphasis> da qualche altra
parte, per esempio in <filename>/autohome</filename> come mostrato in
figura.</para>

<para>Il modulo <literal>autohome</literal> crea una directory home reale se
non esiste nella directory <filename>/autohome</filename>. Dopo la creazione o
il fallimento del tentativo, qualunque sia il risultato,
<literal>autohome</literal> informa  <emphasis role="bold">Autodir</emphasis>.
Quando la creazione della directory &egrave; stata completata con successo, il
percorso alla directory home reale &egrave; fornito <emphasis
role="bold">Autodir</emphasis>.</para>

<para>Se il modulo <literal>autohome</literal> riporta successo, <emphasis
role="bold">Autodir</emphasis> crea la directory <filename>userhome1</filename>
sotto <filename>/home</filename> e monta la <emphasis>directory home
reale</emphasis> da <filename>/autohome</filename> su di essa. Alla fine del
processo, <emphasis role="bold">Autodir</emphasis> informa il kernel se l'intera
operazione ha avuto successo o no. Di conseguenza, il kernel permette alle
applicazioni di entrare nella directory o, in caso di fallimento, riporta che la
directory non esiste.</para>

</sect1>

<sect1>
	<title>Alcune definizioni</title>

<para>Prima di procedere oltre e per semplificare la spiegazione, &egrave;
meglio capire i seguenti termini.</para>

<variablelist>

<varlistentry><term><emphasis role="bold">Directory
virtuali</emphasis></term><listitem><para>Queste directory non esistono su
disco. Sono invece create e cancellate su richiesta in memoria. Se il sistema
riparte tutte queste directory svaniscono. Nella precedente figura, tutte le
directory sotto <filename>/home</filename> sono <emphasis>directory
virtuali</emphasis>.</para></listitem></varlistentry>

<varlistentry><term><emphasis role="bold">Directory base
virtuale</emphasis></term><listitem><para>Questa &egrave; la directory che
contiene tutte le <emphasis>directory virtuali</emphasis>. Questa directory
<emphasis>esiste</emphasis> su disco e quindi rimane anche dopo un riavvio.
Nella figura precedente, <filename>/home</filename> &egrave; <emphasis>la
directory base virtuale</emphasis>.</para></listitem></varlistentry>

<varlistentry><term><emphasis role="bold">Directory
reali</emphasis></term><listitem><para>Queste sono le directory che risiedono
effettivamente su disco. Anche dopo un riavvio, queste rimangono intatte. Nella
precedente figura, tutte le directory create in <filename>/autohome</filename>
sono <emphasis>directory reali</emphasis>.</para></listitem></varlistentry>

<varlistentry><term><emphasis role="bold">Directory base
reale</emphasis></term><listitem><para>&egrave; la directory che contiene tutte
le directory reali. Nella figura precedente, <filename>/autohome</filename>
&egrave; <emphasis>la directory base
reale</emphasis>.</para></listitem></varlistentry>

</variablelist>

<para>Ogni <emphasis>directory virtuale</emphasis> &egrave; mappata su una
<emphasis>directory reale</emphasis>. Questo significa che quello che &egrave;
scritto o modificato nella <emphasis>directory virtuale</emphasis> &egrave; in
realt&agrave; mandato nella <emphasis>directory reale</emphasis>.</para>

<para>Al riavvio del sistema le <emphasis>directory reali</emphasis> ed il loro
contenuto rimangono intatte. Ma le  <emphasis>directory virtuali</emphasis> sono
di nuovo create su richiesta, esattamente come prima.</para>

<para>Le <emphasis>directory virtuali</emphasis> sono rimosse se non utilizzate
per un determinato periodo di tempo e create di nuovo, se necessario. Quando una
<emphasis>directory virtuale</emphasis> &egrave; rimossa, il programma di
backup, se configurato, verr&agrave; avviato sulla corrispondente
<emphasis>directory reale</emphasis>.</para>

<important><para>Le applicazioni dovrebbero accedere solo alle
<emphasis>directory virtuali</emphasis>. Le <emphasis>directory reali</emphasis>
 sono nascoste alle applicazioni. Solo l'utente root pu&ograve; vederle. Esiste
una sola eccezione: il programma di backup pu&ograve; sempre accedere alle sole
<emphasis>directory reali</emphasis>.</para></important>

</sect1>

<sect1 id="dirorg">
<title>Organizzazione delle directory nella directory base reale</title>

<para>Perch&eacute; ci dovrebbe essere una particolare organizzazione delle
directory nella <emphasis>directory base reale</emphasis>? Se tutte le 
<emphasis>directory reali</emphasis> vengono create in un unica
<emphasis>directory base reale</emphasis> ci potrebbe essere un decadimento
delle prestazioni a causa dell'alto numero di <emphasis>directory
reali</emphasis> da creare. File system come ext2 e ext3 non sono ottimizzati
per questo tipo di struttura piatta di directory.</para>

<para>Sarebbe molto meglio se la <emphasis>directory base reale</emphasis>
fosse divisa in molte sottodirectory, o anche se queste sottodirectory fossero
divise a loro volta in altre sottodirectory. Le effettive directory home sarebbe
collocate nell'ultima sottodirectory.</para>

<!-- you are only allowed one exclamation mark in your life, as a rule ;-) -->

<para>Ci sono tre tipi di organizzazione per la directory:</para>

<variablelist>

<varlistentry><term><emphasis role="bold">Livello
0</emphasis></term><listitem><para>Di fatto nessuna organizzazione. Tutte le
directory home sono create direttamente nella <emphasis>directory base
reale</emphasis>.</para></listitem></varlistentry>

<varlistentry><term><emphasis role="bold">Livello
1</emphasis></term><listitem><para>La <emphasis>directory base reale</emphasis>
&egrave; divisa in pi&ugrave; sottodirectory. I nomi delle sottodirectory sono
derivati dal primo carattere della directory finale da creare. Per esempio, se
deve essere creata la directory <filename>user1</filename>, viene prima creata
la directory di nome 'u' sotto la <emphasis>directory base reale</emphasis>.
Quindi in quella sottodirectory l'effettiva directory <filename>user1</filename>
viene creata come 
<filename>/&lt;directory_base_reale&gt;/u/user1</filename>.</para></listitem>
</varlistentry>

<varlistentry><term><emphasis role="bold">Livello
2</emphasis></term><listitem><para>Come l'organizzazione di livello 1, ma dopo
il primo livello di sottodirectory ne viene creato un secondo. I nomi sono i
primi due caratteri del nome della directory finale da creare. Per esempio, per
l'utente <literal>user1</literal>, come nell'esempio precedente, viene creata la
directory 
<filename>/&lt;directory_base_reale&gt;/u/us/user1</filename>.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="vdexp">
<title>La scadenza della directory virtuale</title>

<para>Quando una applicazione cerca di accedere ad una <emphasis>directory
virtuale</emphasis> in una <emphasis>directory base virtuale</emphasis>,
<emphasis role="bold">Autodir</emphasis> crea la <emphasis>directory
virtuale</emphasis> se non esiste gi&agrave; e monta su di essa la
<emphasis>directory reale</emphasis> dalla <emphasis>directory base
reale</emphasis>. Una volta terminato, viene fatto partire un timer. Se non ci
sono accessi alla <emphasis>directory virtuale</emphasis> nella
<emphasis>directory base virtuale</emphasis> da parte di qualsiasi applicazione
per un specificato periodo di tempo, la directory viene rimossa e la
corrispondente <emphasis>directory reale</emphasis> nella <emphasis>directory
base reale</emphasis> &egrave; marcata per il backup.</para>

<para>Il periodo di tempo di scadenza pu&ograve; essere specificato attraverso
un' <link linkend="autodir_t_opt">opzione della linea di comando</link> di
<emphasis role="bold">Autodir</emphasis>.</para>
<!-- FIXME: use xref here instead of link-->
</sect1>

<sect1 id="backup">
	<title>Supporto per il backup</title>

<para> <emphasis role="bold">Autodir</emphasis> supporta il lancio di programmi
di backup quando una <emphasis>directory virtuale</emphasis> &egrave; rimossa
dopo un periodo di attivit&agrave; La rimozione della <emphasis>directory
virtuale</emphasis> &egrave; di per se una garanzia che nessuna applicazione
possa accedervi e modificarla.</para>

<para>Cos&igrave; come c'&egrave; un tempo di attesa per la scadenza di una
<emphasis>directory virtuale</emphasis>, anche per il backup <emphasis
role="bold">Autodir</emphasis> attende un periodo di tempo dopo la scadenza
della <emphasis>directory virtuale</emphasis>, prima di far partire il backup.
Questo periodo di tempo pu&ograve; essere specificato attraverso un'  <link
linkend="autodir_w_opt">opzione della linea di comando</link> di <emphasis
role="bold">Autodir</emphasis>.</para>
<!-- FIXME: use xref here-->
<para>Per impostazione del progetto, i programmi di backup operano sulle
<emphasis>directory reali</emphasis> ma non sulle  <emphasis>directory
virtuali</emphasis>. Se il programma di backup cerca di accedere ad una
<emphasis>directory virtuale</emphasis>, allora <emphasis
role="bold">Autodir</emphasis> suppone che una applicazione normale abbia
bisogno di quella directory e quindi termina il programma di backup, anche se il
processo che sta accedendo alla <emphasis>directory virtuale</emphasis> &egrave;
proprio il programma di backup.</para>

<para>Viene creato un processo di backup separato per ogni <emphasis>directory
reale</emphasis>. Al programma di backup possono essere fornite come  <link
linkend="back_esc_str">argomento</link> le <emphasis>directory reali</emphasis>
sulle quali operare.</para>

<note><para>Il supporto per il backup &egrave; indipendente dal modulo usato.
E' applicabile a tutti i moduli di <emphasis role="bold">Autodir</emphasis>.
</para></note>

<important><title>Backup &egrave; come dire reale!</title><para>I programmi di
backup non dovrebbero mai accedere alla <emphasis>directory virtuale</emphasis>
o alla <emphasis>directory base virtuale</emphasis>.</para></important>
<!--Warnings, notes, tips, cautions and importants all take title tags as children.-->
<caution><title>Avvertenza</title><para>La funzionalit&agrave; di backup non
&egrave; molto utile se le  <emphasis>directory virtuali</emphasis> sono sempre
utilizzate dalle applicazioni.</para></caution>

</sect1>

<sect1 id="backupreq">
<title>Requisiti per il programma di backup</title>

<para><emphasis role="bold">Autodir</emphasis> richiede alcuni requisiti extra
al programma di backup utilizzato: quando il backup &egrave; in corso sulla
<emphasis>directory reale</emphasis>, con la corrispondente <emphasis>directory
virtuale</emphasis> scaduta, e quella <emphasis>directory virtuale</emphasis>
&egrave; richiesta di nuovo da una applicazione, il processo di backup &egrave;
terminato. Prima di tutto viene mandato un segnale di <literal>SIGTERM</literal>
per fermarlo in maniera gentile. Ma se non si ferma in tempo,  ed ha un secondo
per farlo, viene mandato un segnale di <literal>SIGKILL</literal> , il quale
sicuramente lo fermer&agrave;.</para>

<note><para>Solo quando il backup &egrave; stato fermato, l'applicazione
pu&ograve; accedere alla <emphasis role="bold">directory virtuale</emphasis>
richiesta.</para></note>

<important><para>Qualunque programma di backup sia usato, deve essere in grado
di recuperare da questo segnale in maniera corretta, senza causare effetti
secondari irrimediabili.</para></important>

<para>Un altro aspetto importante &egrave; l'ambiente nel quale il backup viene
eseguito. Tutti i programmi di backup sono eseguiti come root. Ma allo stesso
tempo tutti i privilegi di root non necessari sono rimossi utilizzando le
funzionalit&agrave; POSIX. In altre parole questi programmi di backup possono
leggere qualsiasi file o directory che appartiene agli utenti del sistema e
niente di pi&ugrave;. A parte questo, il processo di backup si comporta come un
normale processo a livello utente.</para>

</sect1>

<sect1>
<title>Opzioni dei moduli</title>

<para>Ci sono due tipi di opzioni che si possono passare ad <emphasis
role="bold">Autodir</emphasis>. Quelle del primo tipo sono <link
linkend="aoptions">opzioni</link> per <command>autodir</command> stesso e sono
comuni a qualsiasi modulo venga utilizzato. Lo opzione dell'altro tipo sono
specifiche del modulo usato. Queste sono dette sotto opzioni e sono passate al
modulo utilizzato; sono distinte da quelle principali dall'opzione
<literal>-o</literal>. Il tutto &egrave; molto simile alle sotto opzioni
utilizzate con il comando <command>mount</command>.</para>

<para>Per esempio, le sotto opzioni per il modulo di esempio
<literal>autohome</literal> possono essere passate come segue:</para>

<screen>
-o 'realpath=/tmp/autohome,level=2,noskel'
</screen>

<para>Qui <literal>realpath</literal>, <literal>level</literal> e
<literal>noskel</literal> sono sotto opzioni del modulo
<literal>autohome</literal>.</para>

</sect1>

<sect1>
<title>Requisiti per Autodir</title>

<itemizedlist>
<listitem>
<para>Serve un kernel Linux in versione 2.4 o superiore. Queste versioni del
kernel supportano il montaggio di una directory su un'altra. Al momento
<emphasis role="bold">Autodir</emphasis> non &egrave; stato portato su altri
tipi di Unix ma questo potrebbe cambiare in futuro.</para>
</listitem>

<listitem>
<para><emphasis role="bold">Autodir</emphasis> richiede che il modulo kernel
autofs sia basato sul protocollo 4. Ma il pacchetto a livello utente autofs non
&egrave; necessario. Il modulo kernel autofs &egrave; alquanto standard e
praticamente tutte le distribuzioni lo includono.</para>
</listitem>

</itemizedlist>

</sect1>

<sect1 id="autofs_kmod">
<title>Il modulo kernel autofs</title>

<para><emphasis role="bold">Autodir</emphasis> utilizza il modulo kernel autofs
per il suo funzionamento. Il modulo kernel <literal>autofs</literal> deve
essere caricato prima di far partire  <command>autodir</command>.</para>

<para>Si pu&ograve; fare da root, utilizzando il comando
<command>modprobe</command> come segue:</para>

<screen>
# modprobe autofs
</screen>

</sect1>

<sect1>
<title>Importare gli account di utente e di gruppo</title>
<para>Se gli account di utente e di gruppo risiedono in un database
centralizzato, devono essere importati prima di far partire <emphasis
role="bold">Autodir</emphasis>. Come farlo &egrave; fuori dall'ambito di questo
HowTo. Ci sono numerosi documenti che spiegano in maniera chiara come
farlo.</para>
<!--FIXME: add some links?-->
</sect1>

<sect1>
	<title>Ottenere Autodir</title>

<para>Al momento <emphasis role="bold">Autodir</emphasis> &egrave; disponibile
nei formati tar e rpm. Maggiori informazioni possono essere trovate su <ulink
url="http://www.intraperson.com/autodir/">http://www.intraperson.com/autodir/
</ulink>.</para>

<para>Dopo aver scaricato il codice sorgente, seguire i seguenti semplici passi:</para>

<itemizedlist>

<listitem>
<para>Scompattare il codice sorgente</para>
<para><literal>$ tar zxvf &lt;tar file name&gt;</literal></para>
</listitem>

<!-- use <cmdsynopsis> in the future.-->

<listitem>
<para>Spostarsi nella directory espansa ed eseguire i seguenti comandi:</para>
<para><literal>$ ./configure</literal></para>
<para><literal>$ make</literal></para>
<para><literal># make install</literal></para>
</listitem>
<!--idem-->
</itemizedlist>

<note><title>Non funziona ?</title>
<para>Lo script  <literal>configure</literal> controlla la presenza delle
librerie richieste. Se non ci sono si ferma.</para></note>

</sect1>

<sect1 id="homedir">
<title>Gestire le directory home</title>

<para>Questa sezione spiega come configurare <emphasis
role="bold">Autodir</emphasis> in modo che le directory home degli utenti siano
create su richiesta. Per questo scopo viene usato il modulo
<literal>autohome</literal>, che si occupa in dettaglio della creazione delle
directory home.</para>

<para>Per caricare il modulo <literal>autohome</literal> di <emphasis
role="bold">Autodir</emphasis>, occorre usare l'opzione <literal>-m</literal>.
Per esempio, <literal>-m /usr/lib/autodir/autohome.so</literal>.</para>

<!--use <option> instead of literal for options; use
<application>Autodir</application> instead of <emphasis>.-->

<note><title>Associazione utente/home </title><para>Quando una applicazione
cerca di accedere ad una home directory, quella home directory &egrave;
utilizzata per controllare se esiste un utente con lo stesso nome della
directory. Se il nome dell'utente esiste allora la home directory &egrave;
creata. Altrimenti viene restituito all'applicazione il messaggio <quote>no such
file or directory</quote>.</para></note>

<note><title>Account di utente</title><para><literal>Autohome</literal> non si
occupa della creazione degli account nel sistema locale, in LDAP o in qualsiasi
altro database. Gestisce solo la creazione delle directory home quando questi
account esistono e sono importati nel sistema locale da database come LDAP e
NIS.</para></note>

<important><title>Limitazioni</title><para>Vale la pena di citare una
limitazione del modulo <literal>autohome</literal>. Il modulo assume che il
nome dell'utente e la sua home directory siano collegati l'uno con l'altra. Per
esempio, per l'utente <literal>user1</literal> la home directory dovrebbe essere
<filename>/home/user1</filename> o
<filename>/una/directory/name/user1</filename> ma non 
<filename>/una/directory/nome/userhome1</filename>. Questa situazione potrebbe
essere gestita ma causerebbe un eccessivo uso delle risorse di sistema in quanto
le righe del file password dovrebbero essere controllate dalla prima
all'ultima.</para></important>

<note><title>Capire quando non usare autohome</title><para>Se il database degli
utenti &egrave; definito in modo tale da distribuire le directory home tra
diverse directory base, per esempio <filename>/home/class1/user1</filename>,
<filename>/home/class2/user2332</filename>, allora la configurazione di
<literal>autohome</literal> diventa troppo complicata e quindi il suo uso non
raccomandato.</para></note>

<!-- There are quite some notes in a row here.  Maybe it would be better to
make it just a block of text?-->

<sect2>
<title>Directory base per autohome</title>

<para>Il passo successivo nella procedura di impostazione &egrave; decidere dove
saranno create la <emphasis>directory base virtuale</emphasis> e la
<emphasis>directory base reale</emphasis> per la creazione delle directory
home.</para>

<para>Come sono definite la <emphasis>directory base virtuale</emphasis> e la
<emphasis>directory base reale</emphasis> nel contesto del modulo
<literal>autohome</literal>?</para>

<para>Dipende tutto da come gli account utente sono creati. Se per l'utente
user1 viene creato un account utente con <filename>/home/user1</filename> come
home directory allora <filename>/home</filename> <emphasis>diventer&agrave; la
directory base virtuale</emphasis>.</para>

<para>Allora qual'&egrave; la <emphasis>directory base reale</emphasis>?
Pu&ograve; essere qualsiasi directory. L'unica cosa da tenere a mente &egrave;
verificare che ci sia abbastanza spazio perch&eacute; tutti i file saranno
salvati qui e non nella <emphasis>directory base virtuale</emphasis>.</para>

<para>Nella maggior parte delle configurazioni server <filename>/home</filename>
&egrave; in una partizione separata. Ma se <filename>/home</filename> &egrave;
la <emphasis>directory base virtuale</emphasis>, allora i file non sono
memorizzati in quella directory! La soluzione &egrave; di non fare il montaggio
della partizione su <filename>/home</filename> ma invece da qualche altra parte
e renderla la <emphasis>directory base reale</emphasis>.</para>

<para>L'opzione di <emphasis role="bold">Autodir</emphasis> 
<literal>-d</literal> &egrave; utilizzata per specificare la
<emphasis>directory base virtuale</emphasis>. Per esempio: <literal>autodir -d
/home</literal> definisce   <filename>/home</filename> come la
<emphasis>directory base virtuale</emphasis>.</para>

<!-- In the future replace this syntax with <command>autodir
<option>-d</option> <filename>/home</filename></command>-->

<para>E' talvolta complicato specificare la <emphasis>directory base
reale</emphasis>. La <emphasis>directory base reale</emphasis> &egrave; gestita
dal modulo <literal>autohome</literal> quindi l'opzione deve essere passata al
modulo attraverso le sotto opzioni di modulo. Se la <emphasis>directory base
reale</emphasis> &egrave; <filename>/var/autohome</filename> allora &egrave;
specificata con l'opzione <literal>-o</literal> come in <literal>-o
realpath=/var/autohome</literal>.</para>

</sect2>

<sect2>
<title>Organizzazione delle directory</title>

<para>Si faccia riferimento alla <link linkend="dirorg">organizzazione delle
directory nella directory base reale </link> per una dettagliata spiegazione
dell'argomento.</para>

<!-- here too use xref for readability of links in printed versions-->

<para><literal>autohome</literal> supporta questo tipo di organizzazione. La
sotto opzione usata per specificare il tipo di organizzazione desiderato
&egrave; l'opzione  <literal>level</literal> per esempio: <literal>-o
level=2</literal>.</para>

</sect2>

<sect2>
	<title>Sotto opzioni varie per autohome</title>

<para>La sotto opzione <literal>skel</literal> pu&ograve; essere utilizzata se
il percorso dei file di scheletro non &egrave; quello standard
<filename>/etc/skel</filename>: <literal> -o
skel=/un/altra/dir</literal>.</para>

<para>La sotto opzione <literal>noskel</literal> pu&ograve; essere usata con
<literal>-o</literal> per indicare che i file di scheletro non devono essere
copiati delle directory home quando sono create.</para>

</sect2>

<sect2>
<title>Esempio</title>

<para>Primo, importare gli account utente da un database centralizzato, come ad
esempio LDAP.</para>

<para>Poi, il modulo kernel <literal>autofs</literal> deve essere caricato nel
modulo Linux. Questo pu&ograve; essere fatto come descritto nella <link
linkend="autofs_kmod">sezione sul modulo kernel autofs</link>.</para>

<!-- Question: can this be put in /etc/modules.conf?  Seems a bit strange to me
that you would perform this operation manually all the time.-->

<para>Se <filename>/home</filename> deve essere usato per le directory home
allora <filename>/home</filename> diventa la  <emphasis>directory
virtuale</emphasis>; questo &egrave; indicato ad <command>autodir</command> con
l'opzione <literal>-d /home</literal>.</para>

<para>Supponendo che il modulo <literal>autohome</literal> sia in
<filename>/usr/lib/autodir/autohome.so</filename>, questo modulo pu&ograve;
essere caricato insieme ad  <command>autodir</command> con <literal>-m
/usr/lib/autodir/autohome.so</literal>. Da notare che viene indicato il percorso
completo.</para>

<!--Use of <cmdsynopsis><command></command></cmdsynopsis> would be appropriate here.-->

<para>La vera posizione delle directory home &egrave; indicata con la sotto
opzione <literal>realpath</literal>. Se &egrave;
<filename>/autohome</filename>, la posizione pu&ograve; essere specificata con
<literal>realpath=/autohome</literal>.</para>

<para>Con tutte queste opzioni <command>autodir</command> pu&ograve; essere
fatto partire con:</para>

<screen>
# autodir -d /home 						\
		-m /usr/lib/autodir/autohome.so 		\
		-o 'realpath=/autohome'			 	\
</screen>

<para>Una volta partito <emphasis role="bold">Autodir</emphasis>, la directory
<filename>/home</filename> sar&agrave; inizialmente vuota. Per verificare se
<emphasis role="bold">Autodir</emphasis> sta lavorando correttamente,  si
pu&ograve; entrare in una delle directory home come utente root o come il
proprietario della directory.</para>
<!-- Try to be more direct, for instance:
You can test the correct operation of Autodir by changing directories to...-->

</sect2>

</sect1>

<sect1>
<title>Gestire le directory di gruppo</title>

<para>Il modulo <literal>autogroup</literal> pu&ograve; essere utilizzato per
creare su richiesta directory  di gruppo per un accesso comune. Pu&ograve;
essere utilizzato con Samba, ad esempio, per creare dinamicamente directory
condivise per un gruppo di persone.</para>

<note><title>Controlli</title><para>Il modulo <literal>autogroup</literal>
controlla che la directory richiesta sia per un gruppo valido all'interno del
database di sistema dei gruppi.</para></note>

<!--FIXME: this should be rephrased but I'm not sure exactly how.  Do you mean
that the module checks for permissions on the group dir, refering to i.e.
/etc/group entries?-->

<tip><title>Usare autogroup per la creazione delle directory
home</title><para>Il modulo <literal>autogroup</literal> pu&ograve; essere anche
usato per creare le directory home, assumendo che esista un gruppo privato per
ogni utente . In questo modo tutte le directory home e di gruppo possono essere
create in un solo punto e con un solo modulo. Tuttavia, i file di scheletro non
vengono copiati e la sotto opzione <literal>nopriv</literal> di
<literal>autogroup</literal> non deve essere usata.</para></tip>

<para>La configurazione di <literal>autogroup</literal> &egrave; la stessa del
modulo <literal>autohome</literal>, ma diversamente da
<literal>autohome</literal>, la <emphasis>directory base virtuale</emphasis>
pu&ograve; essere collocata ovunque e con qualsiasi nome. Non &egrave; infatti
controllata da account di sistema.</para>

<para>Il modulo <literal>autogroup</literal> pu&ograve; essere usato con
<emphasis role="bold">Autodir</emphasis> con l'opzione  <literal>-m</literal>.
Per esempio,<literal>-m /usr/lib/autodir/autogroup.so</literal>. </para>

<!--using the <option>-m</option> option;
For example: <command>autodir <option>-d</option> <filename>homedir</filename>
<option>-m</option>
<filename>/usr/lib/autodir/autogroup.so</filename></command>.-->

<para>Tutte le sotto opzioni spiegate in <link linkend="homedir">gestire le
directory home</link> sono valide per  <literal>autogroup</literal>, eccetto
<literal>skel</literal> e <literal>noskel</literal>,le quali non hanno
significato con il modulo <literal>autogroup</literal>. In aggiunta, ci sono
delle sotto opzioni specifiche di <literal>autogroup</literal>. Queste opzioni
sono spiegate qui sotto.</para>
<!-- use <xref linkend="ID" />. -->
<variablelist>

<varlistentry><term><literal>nopriv</literal></term><listitem><para>Alcune
installazioni Linux utilizzano gruppi utente privati Se le directory per questi
gruppi non devono essere create, allora occorre utilizzare questa
opzione.</para></listitem></varlistentry>

</variablelist>

<!--You mentioned suboptionS, plural.  Did you forget additional options, or is
this the only one?  If it is the only one, a listing seems overkill...-->

</sect1>

<sect1 id="aoptions">
	<title>Le opzioni di autodir</title>

<para>In questa sezione vengono spiegate alcune opzioni di <emphasis
role="bold">Autodir</emphasis>. Le opzioni di backup sono spiegate nella <link
linkend="backupopts">sezione backup</link>.</para>
<!-- use xref-->
<variablelist>

<varlistentry><term><literal>-d</literal></term><listitem><para>Specifica la
<emphasis>directory base virtuale</emphasis>. Se il percorso non esiste,
verr&agrave; creato. Questa opzione si aspetta un percorso
assoluto.</para></listitem></varlistentry>

<varlistentry><term
id="autodir_t_opt"><literal>-t</literal></term><listitem><para>Intervallo di
scadenza per le <emphasis>directory virtuali</emphasis>. Per maggiori dettagli
riferirsi alla <link linkend="vdexp">scadenza della directory
virtuale</link>.</para></listitem></varlistentry>

<varlistentry><term><literal>-m</literal></term><listitem><para>Modulo da
usarsi con <emphasis role="bold">Autodir</emphasis>. Attualmente sono
disponibili <literal>autohome</literal> e <literal>autogroup</literal>. Deve
essere specificato il percorso completo del
modulo.</para></listitem></varlistentry>

<varlistentry><term><literal>-o</literal></term><listitem><para>Tutte le sotto
opzioni da passare al modulo sono specificate qui. La sintassi da usare per
passare le opzioni &egrave; simile a quella dell'opzione <literal>-o</literal>
del comando <command>mount</command>. Vedi le sezioni specifiche dei moduli per
maggiori informazioni.</para></listitem></varlistentry>

<varlistentry><term><literal>-f</literal></term><listitem><para>Esegue il
comando in primo piano e registra tutti i messaggi sulla console. A scopo di
debug e per vedere come lavora <emphasis
role="bold">Autodir</emphasis>.</para></listitem></varlistentry>

<varlistentry><term><literal>-l</literal></term><listitem><para>Questa opzione
specifica il percorso di un file nel quale <emphasis
role="bold">Autodir</emphasis> scriver&agrave; il suo ID di
processo.</para></listitem></varlistentry>

<varlistentry><term><literal>-h</literal></term><listitem><para>La guida a
tutte le opzioni supportate da <emphasis
role="bold">Autodir</emphasis>.</para></listitem></varlistentry>

<varlistentry><term><literal>-v</literal></term><listitem><para>Informazioni
sulla versione di <emphasis
role="bold">Autodir</emphasis>.</para></listitem></varlistentry>

</variablelist>

</sect1>


<sect1 id="backupopts">
<title>Opzioni di backup</title>

<para>Queste opzioni sono passate ad <emphasis role="bold">Autodir</emphasis>
per richiedere il supporto al backup.</para>

<variablelist>

<varlistentry><term><literal>-b</literal></term><listitem><para>Questa &egrave;
l'opzione principale per indicare il percorso del programma di backup ed i suoi
argomenti. Il percorso deve essere assoluto, altrimenti <emphasis
role="bold">Autodir</emphasis> non lo accetta.</para></listitem></varlistentry>

<varlistentry><term
id="autodir_w_opt"><literal>-w</literal></term><listitem><para>Se una
<emphasis>directory virtuale</emphasis> non &egrave; utilizzata per un periodo
di tempo, si assume che sia inattiva e viene smontata. Dopo lo smontaggio della
directory, questa opzione definisce se il programma di backup viene eseguito
immediatamente o dopo un intervallo di tempo. Richiede un argomento in secondi.
E' l'intervallo di attesa <emphasis>minimo</emphasis> prima di eseguire il
backup dopo la scadenza della <emphasis>directory virtuale</emphasis>. Non
dovrebbe essere pi&ugrave; grande di un giorno.</para></listitem></varlistentry>

<varlistentry><term><literal>-p</literal></term><listitem><para>E' la
priorit&agrave; da dare al processo di backup. E' compresa tra 1 e 40 inclusi.
Un valore pi&ugrave; basso indica una priorit&agrave; pi&ugrave; alta e
viceversa. Il valore predefinito &egrave; 30.</para></listitem></varlistentry>

<varlistentry><term><literal>-c</literal></term><listitem><para>Limita il
numero di processi di backup attivi allo stesso tempo. Il valore predefinito
&egrave; 150.</para></listitem></varlistentry>
</variablelist>

<caution><title>Usare gli apici</title><para>L'argomento della opzione
<literal>-b</literal> include il percorso assoluto del programma di backup come
anche i suoi argomenti. E' quindi consigliato usare i singoli apici per
delimitare il suo argomento.</para></caution>

<para>L'opzione <literal>-b</literal> richiede il percorso ad un file
eseguibile come anche ad i suoi argomenti. Tuttavia, gli argomenti sono
interpreti alla ricerca di sequenze di caratteri %x che vengono sostituiti da
stringhe predefinite come segue:</para>

<variablelist>

<varlistentry><term><literal>%N</literal></term><listitem><para>Sostituito con
il nome della <emphasis>directory
virtuale</emphasis>.</para></listitem></varlistentry>

<varlistentry
id="back_esc_str"><term><literal>%L</literal></term><listitem><para>Sostituito
con il percorso completo alla <emphasis>directory
reale</emphasis>.</para></listitem></varlistentry>

<varlistentry><term><literal>%K</literal></term><listitem><para>Sostituito con
il nome dell'host.</para></listitem></varlistentry>

<varlistentry><term>Altre</term><listitem><para>Altre sequenze sono passate a
<literal>strftime</literal>. Vedi le pagine di manuale di
<literal>strftime</literal> per maggiori
informazioni.</para></listitem></varlistentry>

</variablelist>

</sect1>

<sect1>
<title>Esempi</title>
<screen>
# autodir -d /home 						\
		-m /usr/lib/autodir/autohome.so 		\
		-t 1000						\
		-f 						\
		-o 'realpath=/autohome,level=1,skel=/etc/skel' 	\
		-l /var/run/autodir.pid
</screen>

<screen>
# autodir -d /home						\
		-m /usr/lib/autodir/autohome.so			\
		-t 300						\
		-b '/bin/tar cf /tmp/%N%F.tar %L'		\
		-w 600						\
		-o 'realpath=/tmp/autohome,level=2,noskel'	\
		-l /var/run/autodir.pid
</screen>

<screen>
# autodir -d /var/abase/ 					\
		-m /usr/lib/autodir/autogroup.so		\
		-t 300						\
		-b '/bin/tar cf /tmp/%N%F.tar %L'		\
		-w 86400					\
		-o 'nopriv,nosetgid,realpath=/var/realbase,level=0' 
</screen>

</sect1>

<sect1>
	<title>Particolarit&agrave; di RPM</title>

<para><emphasis role="bold">Autodir</emphasis> pu&ograve; essere installato da
rpm come segue:</para>
<screen>
# rpm -ivh autodir-0.28-4.i386.rpm
</screen>

<para>Se installato da rpm, sono forniti due script di avvio:
<filename>/etc/rc.d/init.d/autohome</filename> e
<filename>/etc/rc.d/init.d/autogroup</filename>. Il primo serve per eseguire
<emphasis role="bold">Autodir</emphasis> con il modulo
<literal>autohome</literal>, il secondo per eseguirlo con il modulo
<literal>autogroup</literal>.</para>

<para>Gli script di configurazione <filename>/etc/sysconfig/autohome</filename>
e <filename>/etc/sysconfig/autogroup</filename> possono essere usati per
specificare quali opzione devono essere passate ad <emphasis
role="bold">Autodir</emphasis>.</para>

</sect1>

<sect1 id="moreinfo">
	<title>Ulteriori informazioni</title>
<itemizedlist>
<listitem><para><emphasis role="bold">Mailing list su autodir </emphasis><ulink
url="http://lists.sourceforge.net/mailman/listinfo/intraperson-autodir">http://
lists.sourceforge.net/mailman/listinfo/intraperson-autodir</ulink>.</para>
</listitem>

<listitem><para>Il Sito web ufficiale &egrave; <ulink
url="http://www.intraperson.com/autodir/">http://www.intraperson.com/autodir/
</ulink>.</para></listitem>

<listitem><para>Autofs mailing list <ulink
url="http://linux.kernel.org/mailman/listinfo/autofs">http://linux.kernel.org/
mailman/listinfo/autofs</ulink>.</para></listitem>

<listitem><para>L'HowTo su Automount pu&ograve; essere trovato su <ulink
url="http://www.tldp.org">http://www.tldp.org</ulink></para></listitem>

<listitem><para>Autofs Hacking <ulink
url="http://www.goop.org/~jeremy/autofs/">http://www.goop.org/~jeremy/autofs
</ulink>.</para></listitem>
</itemizedlist>

</sect1>

</article>