  Glibc 2 HOWTO
  Eric Green, ejg3@cornell.edu
  v1.5, 8 February 1998

  Questo HOWTO, glibc 2, riguarda l'installazione e l'uso della versione
  2 della libreria GNU C (libc 6) sui sistemi Linux.   Traduzione ital
  iana e manutenzione: Andrea Girotto (andrea.girotto@usa.net)
  ______________________________________________________________________

  Indice Generale


  1. Introduzione.
     1.1 Note su glibc 2.
     1.2 Note su questo documento.
     1.3 Modifiche recenti a questo documento.

  2. Scegliere il proprio metodo di installazione.
  3. Ottenere la libreria.
  4. Installare come libreria di test.
     4.1 Compilare ed installare.
        4.1.1 Prerequisiti.
        4.1.2 Estrarre i sorgenti.
        4.1.3 Configurazione.
        4.1.4 Compilare ed installare.
     4.2 Aggiornare il loader dinamico.
     4.3 Configurare gcc.
     4.4 Aggiornare i collegamenti per header file.
     4.5 Verificare la propria installazione.

  5. Installazione come libreria C primaria
     5.1 Compilare la libreria dai sorgenti.
        5.1.1 Prerequisiti.
        5.1.2 Estrarre i sorgenti.
        5.1.3 Configurazione.
        5.1.4 Compilazione.
     5.2 Prepararsi per l'installazione.
     5.3 Installare dal pacchetto binario.
     5.4 Installare dai sorgenti.
     5.5 Aggiornare i file specs di gcc.
     5.6 Controllare la propria installazione.

  6. Compilare con la libreria non primaria libc.
     6.1 Avviso per l'uso di libc non primarie.
     6.2 Compilare programma con una glibc di test
     6.3 Compilare programmi con libc 5 quando glibc  la libreria primaria.

  7. Compilare programmi C++.
     7.1 Installare libg++ per glibc configurata per test.
     7.2 Installare libg++ per glibc configurata come primaria.
     7.3 Compilare programmi C++ con libc non primaria.

  8. Segnalare bug.
  9. Esempio di file specs.
  10. Miscellanea.
     10.1 Altre informazioni.
        10.1.1 Pagine web.
        10.1.2 Newgroups.
        10.1.3 Mailing lists.
     10.2 Riconoscimenti
     10.3 Segnalazioni.
     10.4 Copyright.


  ______________________________________________________________________

  11..  IInnttrroodduuzziioonnee..



  11..11..  NNoottee ssuu gglliibbcc 22..


  Glibc 2  l'ultima versione della libreria GNU C. Attualmente pu
  essere utilizzata senza modifiche su sistemi GNU Hurd e Linux i386,
  m68k, e sistemi alpha.  Nella versione 2.1 saranno supportate anche le
  macchine Linux PowerPC, MIPS, Sparc, Sparc 64 ed Arm.  In futuro il
  supporto verr esteso ad altre archittetture e sistemi operativi.

  Su Linux, glibc 2  usata come libc con versione principale 6,
  successiva di Linux libc 5.  Con questo si intende comunicare agli
  sviluppatori di sostituire libc 5.  A partire dalla versione 2.0.6,
  glibc  considerata qualit di produzione.  La versione 2.1 (attesa in
  un prossimo futuro) sar pronta per un diffuso uso con l'aggiunta di
  molti adattamenti e caratteristiche.

  Ci sono tre aggiunte opzionali disponibili per glibc 2:

     CCrryypptt
        Il pacchetto UFC-crypt.   separato a causa di restrizioni per
        l'esportazione.

     LLiinnuuxxTThhrreeaaddss
        Implementazione dell'interfaccia Posix 1003.1c "pthread"

     LLooccaallee ddaattaa
        Contiene i dati necessari per costruire i file dati locali da
        usare per le caratteristiche di internazionalizzazione di glibc.

  Si raccomandano caldamente i pacchetti crypt e LinuxThreads... non
  usandoli c' il rischio di essere incompatibili con le librerie di
  altri sistemi.  (Se si desidera non usarli,  necessario aggiungere
  l'opzione --disable-sanity-checks durante la configurazione.)


  11..22..  NNoottee ssuu qquueessttoo ddooccuummeennttoo..


  Questo HOWTO descrive come installare glibc 2 su un sistema Linux
  esistente.   pensato per utenti di sistemi Intel che usino libc 5 in
  ogni caso, utenti di altri sistemi e librerie diverse (come libc 1),
  dovrebbero essere in grado di utilizzare queste informazioni
  sostituendo i nomi di file corretti e i nomi delle architetture dove
  necessario.

  La copia pi recente (in inglese) di questo HOWTO pu essere trovata
  come parte di Linux Documentation Project <http://sunsite.unc.edu/LDP>
  oppure da  <http://www.imaxx.net/~thrytis/glibc/Glibc2-HOWTO.html>.
  Per la rispettiva versione italiana si veda: Italian Linux
  Documentatio Project <http://www.pluto.linux.it/ildp/>.


  11..33..  MMooddiiffiicchhee rreecceennttii aa qquueessttoo ddooccuummeennttoo..


  Differenze tra le versioni 1.5 ed 1.4:

    Indice aggiunto da Ed Bailey.

    Cambiato l'indirizzo email dell'autore.


  Differenze tra le versioni 1.4 e 1.3:

    Modificato lo stato corrente da sperimentale a distribuzione.

    Aggiornata la lista degli adattamenti in corso.

    Aggiornata l'ultima versione a 2.0.6



  22..  SScceegglliieerree iill pprroopprriioo mmeettooddoo ddii iinnssttaallllaazziioonnee..


   possibile installare glibc in diversi modi.  Le librerie possono
  essere installate come test, usando le librerie esistenti come
  predefinite ma lasciando la possibilit di provare le nuove
  utilizzando opzioni diverse durante la compilazione dei programmi.
  Questo tipo di installazione rende facile una futura rimozione di
  glibc (tuttavia qualsiasi programma collegato con glibc non sar pi
  in grado di funzionare se le librerie dovessero essere eliminate).
  Usare glibc come libreria di test richiede la compilazione dai
  sorgenti.  Non ci sono distribuzioni in formato binario per questo
  tipo di configurazione.  L'installazione  descritta in ``Installare
  come libreria di test''.

  L'altro tipo di installazione descritto in questo documento  per
  l'uso di glibc come libreria primaria.  Tutti i nuovi programmi
  compilati sul sistema useranno glibc, tuttavia sar sempre possibile
  collegare programmi alla versione precedente usando differenti opzioni
  di compilazione.   possibile sia installare le librerie precompilate,
  sia compilare le librerie personalmente.  Se si desidera cambiare
  opzioni di ottimizzazione o di configurazione, o usare aggiunte che
  non siano distribuite come pacchetto binario,  necessario avere la
  distribuzione in codice sorgente per la compilazione.  Questa
  procedura di installazione  descritta in ``Installare come libreria C
  primaria''.

  Frodo Looijaard descrive un diverso modo di installare glibc.  Questo
  metodo implica l'installazione di glibc come libreria secondaria e la
  configurazione come compilatore incrociato per l'uso di glibc.  La
  procedura  pi complicata che l'installazione della libreria di test
  descritta in questo documento, ma consente una compilazione pi
  semplice quando si collega glibc.  Il metodo  descritto nel suo
  documento Installing glibc-2 on Linux
  <http://huizen.dds.nl/~frodol/glibc/>.

  Se si sta utilizzando la distribuzione Debian 1.3 ma non si desidera
  aggiornare ad una versione instabile di Debian per usare glibc, il
  documento Debian libc5 to libc6 Mini-HOWTO
  <http://www.gate.net/~storm/FAQ/libc5-libc6-Mini-HOWTO.html> descrive
  come usare i pacchetti Debian per il proprio sistema.

  Se si installa glibc 2 su un sistema importante, si potrebbe usare
  l'installazione di test.  Anche se non ci sono errori, alcuni
  programmi potrebbero aver bisogno di qualche modifica prima che
  possano essere compilati, come conseguenza di alterazioni dei
  prototipi alle funzioni e dei tipi.


  33..  OOtttteenneerree llaa lliibbrreerriiaa..


  La libreria glibc 2 consiste nel pacchetto glibc e tre altri
  opzionali, LinuxThreads, Locale, e Crypt.  Il sorgente pu essere
  trovato presso

    <ftp://prep.ai.mit.edu/pub/gnu/glibc-2.0.6.tar.gz>

    <ftp://prep.ai.mit.edu/pub/gnu/glibc-linuxthreads-2.0.6.tar.gz>

    <ftp://prep.ai.mit.edu/pub/gnu/glibc-localedata-2.0.6.tar.gz>

    <ftp://prep.ai.mit.edu/pub/gnu/glibc-crypt-2.0.6.tar.gz>

  Saranno necessari 150 MB di spazio su disco per la compilazione
  completa e l'installazione.  La libreria base occupa circa 50 MB.

  Pacchetti binari per 2.0.6 non sono disponibili.  Le versioni binarie
  dei pacchetti 2.0.4 per i386 e m68k, e le versioni 2.0.1 per alpha
  sono disponibili:

    Intel x86:

       <ftp://prep.ai.mit.edu/pub/gnu/glibc-2.0.4.bin.i386.tar.gz>

       <ftp://prep.ai.mit.edu/pub/gnu/glibc-
        crypt-2.0.4.bin.i386.tar.gz>

    Alpha:

       <ftp://prep.ai.mit.edu/pub/gnu/glibc-2.0.1.bin.alpha-
        linux.tar.gz>

       <ftp://prep.ai.mit.edu/pub/gnu/glibc-crypt-2.0.1.bin.alpha-
        linux.tar.gz>

    m68k:

       <ftp://prep.ai.mit.edu/pub/gnu/glibc-2.0.4-m68k-
        linux.bin.tar.gz>

       <ftp://prep.ai.mit.edu/pub/gnu/glibc-crypt-2.0.4-m68k-
        linux.bin.tar.gz>

  Ci sono restrizioni di esportazione per le aggiunte crittografiche.
  Utenti non Statunitensi possono recuperare una versione presso
  <ftp://ftp.ifi.uio.no/pub/gnu>.

  Se si utilizza una distribuzione Red Hat,  possibile avere gli rpm
  per glibc 2 da  <ftp://ftp.redhat.com/pub/redhat/>.  Glibc 2  la
  libreria primaria per la nuova distribuzione Red Hat 5.0.

  Se si utilizza una distribuzione Debian,  possibile avere i pacchetti
  per glibc 2 da  <ftp://ftp.debian.org/debian/dists/unstable/main/>.  I
  file sono nominati libc6.  Glibc 2 ora  parte del pacchetto base per
  la versione hamm di Debian, e sar la libc primaria quando Debian 2.0
  sar rilasciata.



  44..  IInnssttaallllaarree ccoommee lliibbrreerriiaa ddii tteesstt..


  Questa sezione descrive come installare glibc 2 come libreria di test.
  Qualsiasi cosa compilata sar collegata alle librerie esistenti a meno
  che non si usino alcuni parametri extra per il collegamento alle nuove
  librerie.  Pare che i percorsi siano compilati in pochi file, quindi
  probabilmente  necessario installare la libreria dalla versione
  sorgente.



  44..11..  CCoommppiillaarree eedd iinnssttaallllaarree..



  44..11..11..  PPrreerreeqquuiissiittii..



    Circa 150 MB di spazio libero

    GNU make 3.75

    gcc >= 2.7.2 (meglio 2.7.2.1)

    binutils 2.8.1 (per alpha  necessario ???)

    bash 2.0

    autoconf 2.12 (se si cambia configure.in)

    texinfo 3.11

  Su un i586@133 con 64 MB di RAM, sono necessarie circa 3 ore per
  compilare le librerie complete con le aggiunte.  Su un i686@200
  carico,  necessaria circa mezz'ora.


  44..11..22..  EEssttrraarrrree ii ssoorrggeennttii..


   necessario estrarre i sorgenti dagli archivi cos che si possano
  compilare.  Il modo migliore per farlo :


        tar xzf glibc-2.0.6.tar.gz
        cd glibc-2.0.6
        tar xzf ../glibc-linuxthreads-2.0.6.tar.gz
        tar xzf ../glibc-crypt-2.0.6.tar.gz
        tar xzf ../glibc-localedata-2.0.6.tar.gz



  Questi comandi estrarranno le directory linuxthreads, crypt e locale
  data in glibc-2.0.6 dove configure potr trovare le rispettive
  aggiunte.


  44..11..33..  CCoonnffiigguurraazziioonnee..


  Nella directory glibc-2.0.6, se ne crea un'altra chiamata compile, e
  la si rende corrente.  Tutto il lavoro sar fatto in questa directory,
  cosa che semplificher la pulizia.  (Gli sviluppatori non sono ancora
  stati in grado di realizzare un 'make clean' perfetto.)


        mkdir compile
        cd compile



  Si esegue ../configure.  Per usare i pacchetti aggiuntivi,  neces
  sario specificarli con --enable-add-ons, ad esempio --enable-add-
  ons=linuxthreads,crypt,localedata.   anche necessario scegliere una
  directory di installazione.  /usr/i486-linuxglibc2  una buona scelta.
  Il comando per configure quindi sar:


        ../configure --enable-add-ons=linuxthreads,crypt,localedata --prefix=/usr/i486-linuxglibc2



  44..11..44..  CCoommppiillaarree eedd iinnssttaallllaarree..


  Per compilare e verificare, si esegue:


        make
        make check



  Se il comando 'make check' ha successo, installare la libreria:


        make install



  44..22..  AAggggiioorrnnaarree iill llooaaddeerr ddiinnaammiiccoo..



  1. Creare un collegamento dal nuovo ld.so a /lib/ld-linux.so.2:


        ln -s /usr/i486-linuxglibc2/lib/ld-linux.so.2 /lib/ld-linux.so.2



  Questa  la sola libreria la cui locazione  prefissata una volta che
  un programma sia stato collegato e l'uso di un riferimento in /lib
  faciliter l'aggiornamento a glibc come libreria C primaria, una volta
  che la versione stabile sia stata rilasciata.

  2. Modificare /etc/ld.so.conf.   necessario aggiungere un percorso
     alla directory lib dove le nuove librerie risiedono, che sar
     <prefix>/lib, come /usr/i486-linuxglibc2/lib per la scelta
     precedente.  Dopo aver corretto /etc/ld.so.conf, si esegue


        ldconfig -v



  44..33..  CCoonnffiigguurraarree ggcccc..

  L'ultimo passo dell'installazione  aggiornare /usr/lib/gcc-lib in
  modo che gcc sappia come usare le nuove librerie.  Per prima cosa 
  necessario duplicare la configurazione esistente. Per verificare la
  configurazione corrente, si usa l'opzione -v:
        % gcc -v
        Reading specs from /usr/lib/gcc-lib/i486-unknown-linux/2.7.2.2/specs
        gcc version 2.7.2.2



  In questo caso,  i486-unknown-linux  il sistema e 2.7.2.2  la ver
  sione.   necessario copiare /usr/lib/gcc-lib/<system> nella nuova
  directory di test per il sistema:


        cd /usr/lib/gcc-lib/
        cp -r i486-unknown-linux i486-linuxglibc2



  Si rende corrente la nuova directory test di sistema e la directory di
  versione


        cd /usr/lib/gcc-lib/i486-linuxglibc2/2.7.2.2



  e si corregge il file specs presente.  In questo file, si cambia
  /lib/ld-linux.so.1 a /lib/ld-linux.so.2.  Inoltre  necessario anche
  eliminare tutte le espressioni %{...:-lgmon} nel file, dal momento che
  glibc non usa la libreria gmon per il profiling.  Un esempio di file
  specs pu essere trovato nella sezione ``Esempio file specs''.


  44..44..  AAggggiioorrnnaarree ii ccoolllleeggaammeennttii ppeerr hheeaaddeerr ffiillee..

   necessario creare collegamenti nella nuova directory di link alle
  altre directory include:


        cd /usr/i486-linuxglibc2/include
        ln -s /usr/src/linux/include/linux
        ln -s /usr/src/linux/include/asm
        ln -s /usr/X11R6/include/X11



  Alcune librerie come ncurses necessitano di avere i propri file posti
  in questa directory.  Si dovr copiare o collegare i file in questione
  da /usr/include.  (Probabilmente sar necessario ricompilarne alcune
  con glibc2 per farle funzionare.  In questi casi, basta compilare ed
  installare il pacchetto in /usr/i486-linuxglibc2.)


  44..55..  VVeerriiffiiccaarree llaa pprroopprriiaa iinnssttaallllaazziioonnee..


  Per verificare l'installazione, si crei il seguente programma in un
  file glibc.c:



   #include <stdio.h>

   main()
   {
       printf("hello world!\n");
   }



  e si compili con l'opzione "-b <directory base> -nostdinc -I<directory
  installazione>/include -I/usr/lib/gcc-lib/<nuova directory di sis
  tema>/<gcc version>/include":


        % gcc -b i486-linuxglibc2 -nostdinc -I/usr/i486-linuxglibc2/include
       -I/usr/lib/gcc-lib/i486-linuxglibc2/2.7.2.2/include glibc.c -o glibc



  Si usi ldd per verificare che il programma  stato collegato con
  glibc2 e non la vecchia libc:


        % ldd glibc
        libc.so.6 => /usr/i486-linuxglibc2/lib/libc-2.0.6.so (0x4000d000)
        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)



  Se compila, i collegamenti risultano e l'output del programma quando
  eseguito  "hello world!" l'installazione ha avuto successo.



  55..  IInnssttaallllaazziioonnee ccoommee lliibbrreerriiaa CC pprriimmaarriiaa


  Questa sezione descrive l'installazione di glibc 2 come libreria
  primaria.  Qualsiasi nuovo programma compilato sar collegato con
  questa libreria, a meno che non si usino particolari opzioni per
  qualche altra versione.

  Se si dispone di una distribuzione Redhat o Debian, dopo aver
  prelevato i file rpm o deb appropriati, consultare le istruzioni per
  l'installazione. In questo caso si pu saltare la sezione che segue.



  55..11..  CCoommppiillaarree llaa lliibbrreerriiaa ddaaii ssoorrggeennttii..


  Questa sezione spiega come compilare glibc 2 e le aggiunte a partire
  dai sorgenti.  necessario compilare la libreria se si desidera
  cambiare opzioni di ottimizzazione o configurazione o usare un
  pacchetto di cui non si dispongano i binari.


  55..11..11..  PPrreerreeqquuiissiittii..



    Circa 150 MB di spazio libero su disco

    GNU make 3.75

    gcc >= 2.7.2 (meglio 2.7.2.1)

    binutils 2.8.1 (per alpha  necessario a ? )

    bash 2.0

    autoconf 2.12 (se si modifica configure.in)

    texinfo 3.11

  Su un i586@133 con 64 MB di RAM, sono necessarie circa 3 ore per
  compilare completamente librerie e aggiunte. Su un i686@200 "carico",
   necessaria circa mezzora.


  55..11..22..  EEssttrraarrrree ii ssoorrggeennttii..


   necessario estrarre i sorgenti dagli archivi in modo da poterli
  compilare.  Il modo migliore per farlo :


        tar xzf glibc-2.0.6.tar.gz
        cd glibc-2.0.6
        tar xzf ../glibc-linuxthreads-2.0.6.tar.gz
        tar xzf ../glibc-crypt-2.0.6.tar.gz
        tar xzf ../glibc-localedata-2.0.6.tar.gz



  Questa sequenza di comandi dispone le directory linuxthreads, crypt, e
  localedata in glibc-2.0.6 dove  possibile configurare queste
  aggiunte.


  55..11..33..  CCoonnffiigguurraazziioonnee..


  Si crei una directory di nome compile in glibc-2.0.6, e la si renda
  directory corrente.  Tutto il lavoro sar fatto in questa directory,
  cosa che semplificher la pulizia.  (Gli sviluppatori non sono ancora
  stati in grado di realizzare un 'make clean' perfetto.)


       mkdir compile
       cd compile



  Si esegua ../configure.  Per usare i pacchetti aggiuntivi,  neces
  sario specificarli con  --enable-add-ons, come in --enable-add-
  ons=linuxthreads,crypt,localedata.  Probabilmente si desiderer anche
  specificare i percorsi dove debbano essere installati. Per adeguarsi
  alle distribuzioni standard di Linux, si specifichi --prefix=/usr.
  (Quando un prefisso di /usr  specificato su un sistema linux, config
  ure sa come sistemare i percorsi rimanenti per disporre libc.so e le
  altre librerie importanti in /lib.)  La linea completa di configu
  razione dovrebbe essere:

   ../configure --enable-add-ons=linuxthreads,crypt,localedata --prefix=/usr



  55..11..44..  CCoommppiillaazziioonnee..


  Per compilare e verificare, si esegua:


        make
        make check



  55..22..  PPrreeppaarraarrssii ppeerr ll''iinnssttaallllaazziioonnee..


  Ora  necessario spostare alcuni file per prepararsi per la nuova
  libreria, a seconda che si stia installando dai sorgenti o dai binari.
  Ogni nuovo programma compilato sar collegato alla glibc, ma programmi
  vecchi che non sono collegati staticamente dipenderanno ancora dal
  libc 5, per questo non  possibile semplicemente sovrascrivere la
  vecchia versione.


  1. Creare una nuova directory per contenere i vecchi file:


         mkdir -p /usr/i486-linuxlibc5/lib



  2. I vecchi file di header devono essere rimosssi da /usr/include:


        mv /usr/include /usr/i486-linuxlibc5/include



  3. Creare una nuova directory per i file include ed assegnare i
     collegamenti per includere altre directory:


        mkdir /usr/include

        ln -s /usr/src/linux/include/linux /usr/include/linux
        ln -s /usr/src/linux/include/asm /usr/include/asm
        ln -s /usr/X11R6/include/X11 /usr/include/X11
        ln -s /usr/lib/g++-include /usr/include/g++



  I collegamenti potrebbero essere diversi a seconda della distribuzione
  di cui si dispone.  Ad esempio Slackware pone gli header g++ in
  /usr/local/g++-include, mentre Debian in /usr/include/g++, e collega
  /usr/lib/g++-include a /usr/include/g++.  Nell'ultimo caso, probabil
  mente si desiderer spostare la directory originale di nuovo in
  /usr/include.

  4. Ripristinare ogni file di header o collegamento extra.  Alcune
     librerie non standard come ncurses pongono i propri file in
     /usr/include oppure creano un link alla loro directory di include
     in /usr/include.   necessario ripristinare questi file e
     collegamenti al fine di poter usare correttamente le librerie
     extra.

  5. Aggiungere la nuova directory della libreria (ad esempio
     /usr/i486-linuxlibc5/lib) _a_l_l_'_i_n_i_z_i_o del proprio file
     /etc/ld.so.conf.   necessario avere ld.so 1.8.8 (o pi recente)
     per evitare alcuni strani messaggi una volta che glibc sia
     installata.

  6. Spostare/copiare tutte le librerie C vecchie nella nuova directory.


        mv /usr/lib/libbsd.a /usr/i486-linuxlibc5/lib
        mv /usr/lib/libc.a /usr/i486-linuxlibc5/lib
        mv /usr/lib/libgmon.a /usr/i486-linuxlibc5/lib
        mv /usr/lib/libm.a /usr/i486-linuxlibc5/lib
        mv /usr/lib/libmcheck.a /usr/i486-linuxlibc5/lib
        mv /usr/lib/libc.so /usr/i486-linuxlibc5/lib
        mv /usr/lib/libm.so /usr/i486-linuxlibc5/lib
        cp /lib/libm.so.5.* /usr/i486-linuxlibc5/lib
        cp /lib/libc.so.5.* /usr/i486-linuxlibc5/lib



  libm.so.5 e libc.so.5 dovrebbero essere copiate e non spostate se /usr
   una partizione separata da /, in quanto sono necessarie per i pro
  grammi usati per far partire linux e devono risiedere nella partizione
  di root.

  7. Spostare i file /usr/lib/*.o nella nuova directory.


        mv /usr/lib/crt1.o /usr/i486-linuxlibc5/lib
        mv /usr/lib/crti.o /usr/i486-linuxlibc5/lib
        mv /usr/lib/crtn.o /usr/i486-linuxlibc5/lib
        mv /usr/lib/gcrt1.o /usr/i486-linuxlibc5/lib



  8. Aggiornare la propria cache dopo lo spostamento delle librerie


        ldconfig -v



  55..33..  IInnssttaallllaarree ddaall ppaacccchheettttoo bbiinnaarriioo..


  Se si sta installando glibc da codice binario precompilato, si deve:


        cd /
        gzip -dc glibc-2.0.bin.i386.tar.gz | tar tvvf -
        gzip -dc glibc-crypt-2.0.bin.i386.tar.gz | tar tvvf -
        ldconfig -v



  Con differenti archittetura o versione, sostituire i nomi di file
  adeguati.



  55..44..  IInnssttaallllaarree ddaaii ssoorrggeennttii..


  Per installare la libreria dai sorgenti, si esegua:


        make install
        ldconfig -v



  55..55..  AAggggiioorrnnaarree ii ffiillee ssppeeccss ddii ggcccc..


  Il passo finale dell'installazione (sia nel caso di codice binario che
  sorgente)  di aggionrare il file specs di gcc, in modo da poter
  collegare correttamente i propri programmi. Per determinare quale file
  specs sia quello usato da gcc, si usi:


        % gcc -v
        reading specs from /usr/lib/gcc-lib/i486-unknown-linux/2.7.2.2/specs
        gcc version 2.7.2.2



  In questo caso i486-unknown-linux  il sistema, e 2.7.2.2 la versione.
   necessario copiare il file /usr/lib/gcc-lib/<system> nella vecchia
  directory di sistema


        cd /usr/lib/gcc-lib/
        cp -r i486-unknown-linux i486-linuxlibc5



  Andare nella directory originale e quella di versione

   cd /usr/lib/gcc-lib/i486-unknown-linux/2.7.2.2



  per modificare il file specs presente in questa directory.  Nel file,
  si cambi /lib/ld-linux.so.1 in /lib/ld-linux.so.2.  Inoltre 
  necessario rimuovere tutte le espressioni %{...:-lgmon} presenti nel
  file, dal momento che glibc non usa la libreria gmon per il profiling.
  Un esempio di file specs pu essere trovato nella sezione ``Esempio di
  file specs''.



  55..66..  CCoonnttrroollllaarree llaa pprroopprriiaa iinnssttaallllaazziioonnee..


  Per verificare l'installazione, si crei il seguente programma in un
  file glibc.c:


        #include <stdio.h>

        main()
        {
            printf("hello world!\n");
        }



  e si compili il programma.


        % gcc glibc.c -o glibc



  Usando ldd  possibile verificare che il programma  stato collegato
  con glibc2 e non la vecchia libc:


        % ldd glibc
        libc.so.6 => /lib/libc.so.6 (0x4000e000)
        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)



  Se il programma si compila e genera "hello world!" quando eseguito,
  l'installazione  corretta.


  66..  CCoommppiillaarree ccoonn llaa lliibbrreerriiaa nnoonn pprriimmaarriiaa lliibbcc..


  Ci sono situazioni in cui si desidera usare una libreria alternativa
  con cui compilare i propri programmi.  Questa sezione spiega come
  raggiungere questo scopo, usando le directory ed i nomi di
  installazione degli esempi delle precedenti due sezioni.  Si ricordi
  di correggere i nomi secondo la propria configurazione.
  66..11..  AAvvvviissoo ppeerr ll''uussoo ddii lliibbcc nnoonn pprriimmaarriiee..

  Prima di compilare un programma che sar usato nella fase di boot del
  sistema, si ricordi che se il programma  collegato dinamicamente ed 
  usato prima che le partizioni non root siano montate, tutte le
  librerie collegate dovranno essere presenti nella partizione di root.
  Seguendo il percorso di installazione della precedente sezione su come
  installare glibc come libreria primaria, la vecchia libreria 
  lasciata in /lib, che sar nella propria partizione di root.  Questo
  significa che tutti i programmi saranno in grado di funzionare durante
  la fase di boot.  Tuttavia se /usr  su una diversa partizione e si
  installa glibc come libreria di test in /usr/i486-linuxglibc2,
  qualsiasi nuovo programma compilato con glibc non funzioner fino a
  quando non si sia montata /usr.


  66..22..  CCoommppiillaarree pprrooggrraammmmaa ccoonn uunnaa gglliibbcc ddii tteesstt

  Per compilare un programma con una installazione di prova di glibc, 
  necessario impostare i percorsi di include a quelli di glibc.
  Specificando "-nostdinc" si negheranno i normali percorsi, e
  "-I/usr/i486-linuxglibc2/include" far puntare agli include di glibc.
  Sar anche necessario specificare gli include di gcc che si trovano in
  /usr/lib/gcc-lib/i486-linuxglibc2/2.7.2.2/include (assumendo che si
  sia installata la libreria di test in i486-linuxglibc2 con versione di
  gcc 2.7.2.2).

  Per collegare un programma con una libreria di prova glibc, 
  necessario specificare la configurazione di gcc.  Questo si ottiene
  usando l'opzione "-b i486-linuxglibc2".

  Per la maggior parte dei programmi, si possono specificare queste
  nuove opzioni aggiungendole alle opzioni di makefile $CFLAGS e
  $LDFLAGS:


        CFLAGS = -nostdinc -I/usr/i486-linuxglibc2/include
       -I/usr/lib/gcc-lib/i486-linuxglibc2/2.7.2.2/include -b i486-linuxglibc2
        LDFLAGS = -b i486-linuxglibc2



  Se si sta usando uno script di configurazione, si definiscano le vari
  abili d'ambiente $CFLAGS e $LDFLAGS (usando env/setenv per csh/tcsh, o
  set/export per sh/bash/etc) prima di eseguire configure.  I makefile
  generati in questo modo dovrebbero avere $CFLAGS e $LDFLAGS corretti.
  Non tutti i file di configurazione fanno riferimento a queste vari
  abili, quindi  necessario controllare l'esecuzione di configure e
  correggere manualmente i makefile se necessario.

  Se i programmi che si compilano eseguono solo gcc (e non direttamente
  cpp o binutils), si pu usare lo script che segue per evitare di
  scrivere tutte le opzioni:


        #!/bin/bash
        /usr/bin/gcc -b i486-linuxglibc2 -nostdinc \
                     -I/usr/i486-linuxglibc2/include \
                     -I/usr/lib/gcc-lib/i486-linuxglibc2/2.7.2.2/include "$@"



  Si pu usare questo script invece di "gcc" per la compilazione.


  66..33..  CCoommppiillaarree pprrooggrraammmmii ccoonn lliibbcc 55 qquuaannddoo gglliibbcc  llaa lliibbrreerriiaa pprrii
  mmaarriiaa..

  Per compilare un programma con le vecchie librerie avendo installato
  glibc come libreria primaria,  necessario impostare i percorsi di
  inclusione ai vecchi include.  Specificando "-nostdinc" si nega
  all'accesso al percorso normale, e "-I/usr/i486-linuxlibc5/include"
  far puntare agli include di libc. Inoltre  necessario specificare
  "-I/usr/lib/gcc-lib/i486-linuxlibc5/2.7.2.2/include" per accedere a
  specifici include gcc.  Si ricordi di correggere questi percorsi sulla
  base dei nomi che si sono dati alle proprie directory e versione di
  gcc.

  Per collegare un programma con la propria vecchia libc,  necessario
  specificare la configurazione, ed  fatto con: "-b i486-linuxlibc5".

  Per la maggior parte dei programmi, si pu specificare le nuove
  opzioni aggiungedole alle opzioni di makefile $CFLAGS e $LDFLAGS:


        CFLAGS = -nostdinc -I/usr/i486-linuxlibc5/include
       -I/usr/lib/gcc-lib/i486-linuxlibc5/2.7.2.2/include -b i486-linuxlibc5
        LDFLAGS = -b i486-linuxlibc5



  Se si sta usando uno script di configurazione, si definiscano le vari
  abili d'ambiente $CFLAGS e $LDFLAGS (usando env/setenv per csh/tcsh, o
  set/export per sh/bash/etc) prima di eseguire configure.  I makefile
  generati in questo modo dovrebbero avere $CFLAGS e $LDFLAGS corretti.
  Non tutti i file di configurazione fanno riferimento a queste vari
  abili, quindi  necessario controllare l'esecuzione di configure e
  correggere manualmente i makefile se necessario.

  Se i programmi che si compilano eseguono solo gcc (e non direttamente
  cpp o binutils), si pu usare lo script che segue per evitare di
  scrivere tutte le opzioni:


        #!/bin/bash
        /usr/bin/gcc -b i486-linuxlibc5 -nostdinc \
                     -I/usr/i486-linuxlibc5/include \
                     -I/usr/lib/gcc-lib/i486-linuxlibc5/2.7.2.2/include "$@"



  Si pu usare questo script invece di "gcc" per la compilazione.



  77..  CCoommppiillaarree pprrooggrraammmmii CC++++..


  Libg++ usa alcune parti della libreria matematica, come pure il
  collegamento a libm.  Da momemnto che la libg++ esistente  stata
  compilata con la propria precedente libreria,  necessario ricompilare
  libg++ con glibc per avere una copia binaria.  L'ultima versione
  sorgente per libg++ insieme con la versione binaria compilata con
  glibc (per x86) pu essere trovata presso:
  <ftp://ftp.yggdrasil.com/private/hjl/>.


  77..11..  IInnssttaallllaarree lliibbgg++++ ppeerr gglliibbcc ccoonnffiigguurraattaa ppeerr tteesstt..

  Avendo installato glibc come libreria di test,  necessario installare
  i file nella directory dove risiede glibc (che  /usr/i486-linuxglibc2
  per gli esempi delle sezioni precedenti). Installando da un pacchetto
  in formato binario (cosa che l'autore consiglia in quanto non  mai
  riuscito a compilare con successo libg++ in questo modo),  necessario
  estrarre i file in una directory temporanea e spostare tutti i file da
  usr/lib/ in <directory di installazione>/lib/, da usr/include/ in
  <directory di installazione>/include/ (ricordarsi prima di rimuovere
  il link include/g++!), ed infine da usr/bin/ in <directory di
  installazione>/bin/.


  77..22..  IInnssttaallllaarree lliibbgg++++ ppeerr gglliibbcc ccoonnffiigguurraattaa ccoommee pprriimmaarriiaa..

  Avendo installato glibc come libreria primaria e volendo mantenere la
  possibilit di compilare programmi con la vecchia versione di libc, 
  necessario spostare - prima della nuova installazione - tutti i file
  nella directory di libc. Probabilmente il modo pi semplice per farlo
   di installare una copia di libg++ compilata per libc5 come nella
  sezione precedente, e poi installare normalmente glibc.


  77..33..  CCoommppiillaarree pprrooggrraammmmii CC++++ ccoonn lliibbcc nnoonn pprriimmaarriiaa..

  Per compilare programmi C++ con una libreria non primaria libc, 
  necessario specificare la directory di include g++ che negli esempi
  precedenti  /usr/i486-linuxglibc2/include/g++ per l'installazione di
  glibc come libreria di test e /usr/i486-linuxlibc5/include/g++ per
  l'installazione di glibc come libreria primaria. Normalmente si
  raggiunge questo scopo impostando la variabile $CXXFLAGS:


        CXXFLAGS = -nostdinc -I/usr/i486-linuxglibc2/include -I/usr/lib/gcc-lib/i486-linuxglibc2/2.7.2.2/include -I/usr/i486-linuxlibc5/include/g++ -b i486-linuxglibc2



  88..  SSeeggnnaallaarree bbuugg..


  Se si pensa che la libreria contenga un errore, per prima cosa si
  consulti il file FAQ.  possibile che altri abbiano avuto lo stesso
  problema e che ci sia una soluzione facile. Inoltre  necessario
  controllare la sezione "Tools consigliati per l'installazione della
  libraria GNU C" nel file "INSTALL" dal momento che alcuni sono bug dei
  tool e non della libreria.

  Una volta scoperto un errore  necessario sincerarsi che sia veramente
  un errore. Un buon modo  confrontare il comportamento della GNU con
  altre librerie C. Se  lo stesso, probabilmente non si tratta di un
  bug (ma non  detto), altrimenti una delle librerie quasi certamente 
  errata.

  Passo successivo, consultare il database di bug presso: http://www-
  gnats.gnu.org:8080/cgi-bin/wwwgnats.pl <http://www-
  gnats.gnu.org:8080/cgi-bin/wwwgnats.pl>. Verificare che il problema
  non sia gi stato segnalato. Sarebbe anche il caso di controllare il
  file BUGS distribuito con libc per vedere l'elenco dei bug conosciuti.

  Scovato un errore di cui si  certi, si cerchi di restringerlo al caso
  di test pi compatto possibile. Nel caso di una libreria C, dovrebbe
  essere possibile restringerlo ad una sola chiamata di libreria. Il
  compito non dovrebbe essere troppo difficile.

  Il passo finale consiste nello scrivere un semplice caso di test per
  segnalare l'errore. Comunicando il problema, si spedisce il test, i
  risultati ottenuti, i risultati attesi, quale si ritiene essere il
  problema se si ha una qualche opinione), il tipo di sistema, la
  versione della libreria GNU C, il compilatore GNU CC, e la versione
  delle binutils GNU che si sta usando. Si aggiungano anche i file
  config.status e config.make che si ottengono eseguendo configure; si
  troveranno nella directory corrente al momento in cui si esegue
  configure.

  Tutte le segnalazioni devono essere mandate usando lo script glibcbug
  fornito con la GNU libc all'indirizzo  <bugs@gnu.org> (l'indirizzo pi
  vecchio  <bugs@gnu.ai.mit.edu>  ancora operativo), oppure comunicate
  con l'interfaccia web di GNATS <http://www-gnats.gnu.org:8080/cgi-
  bin/wwwgnats.pl>.

  Suggerimenti e domande possono essere indirizzati all'indirizzo <bugs-
  glibc@prep.ai.mit.edu>. Se non si legge il newsgroup gnu.bug.glibc, 
  possibile iscriversi alla lista chiedendo a <bug-glibc-
  request@prep.ai.mit.edu>.

  Per favore NON si comunichino bug all'indirizzo <bug-
  gcc@prep.ai.mit.edu>.  Questa lista  per segnalare problemi per GNU
  CC. GNU CC e GNU C lib sono entit separate gestite da persone
  diverse.



  99..  EEsseemmppiioo ddii ffiillee ssppeeccss..


  Si include un esempio di file spec per glibc 2, usato da gcc per la
  compilazione ed il collegamento.  Dovrebbe essere presente nella
  directory /usr/lib/gcc-lib/<nuova directory sistema>/<versione gcc>.
  Se si sta usando un sistema x86, probabilmente  possibile copiare
  esattamente questa sezione nel file.



   *asm:
   %{V} %{v:%{!V:-V}} %{Qy:} %{!Qn:-Qy} %{n} %{T} %{Ym,*} %{Yd,*} %{Wa,*:%*}

   *asm_final:
   %{pipe:-}

   *cpp:
   %{fPIC:-D__PIC__ -D__pic__} %{fpic:-D__PIC__ -D__pic__} %{!m386:-D__i486__} %{posix:-D_POSIX_SOURCE} %{pthread:-D_REENTRANT}

   *cc1:
   %{profile:-p}

   *cc1plus:


   *endfile:
   %{!shared:crtend.o%s} %{shared:crtendS.o%s} crtn.o%s

   *link:
   -m elf_i386 %{shared:-shared}   %{!shared:     %{!ibcs:       %{!static:   %{rdynamic:-export-dynamic}      %{!dynamic-linker:-dynamic-linker /lib/ld-linux.so.2}}   %{static:-static}}}

   *lib:
   %{!shared: %{pthread:-lpthread}  %{profile:-lc_p} %{!profile: -lc}}

   *libgcc:
   -lgcc

   *startfile:
   %{!shared:      %{pg:gcrt1.o%s} %{!pg:%{p:gcrt1.o%s}                        %{!p:%{profile:gcrt1.o%s}                    %{!profile:crt1.o%s}}}}    crti.o%s %{!shared:crtbegin.o%s} %{shared:crtbeginS.o%s}

   *switches_need_spaces:


   *signed_char:
   %{funsigned-char:-D__CHAR_UNSIGNED__}

   *predefines:
   -D__ELF__ -Dunix -Di386 -Dlinux -Asystem(unix) -Asystem(posix) -Acpu(i386) -Amachine(i386)

   *cross_compile:
   0

   *multilib:
   . ;



  1100..  MMiisscceellllaanneeaa..

  1100..11..  AAllttrree iinnffoorrmmaazziioonnii..



  1100..11..11..  PPaaggiinnee wweebb..



    FSF's GNU C Library Home Page
     <http://www.gnu.org/software/libc/libc.html>


    Using GNU Libc 2 with Linux <http://www.imaxx.net/~thrytis/glibc/>

    Installing glibc-2 on Linux <http://huizen.dds.nl/~frodol/glibc/>.

    Debian libc5 to libc6 Mini-HOWTO
     <http://www.gate.net/~storm/FAQ/libc5-libc6-Mini-HOWTO.html>.


  1100..11..22..  NNeewwggrroouuppss..



    comp.os.linux.development.system

    comp.os.linux.development.apps

    linux.dev.kernel

    gnu.bugs.glibc


  1100..11..33..  MMaaiilliinngg lliissttss..



     LLiissttaa LLiinnuuxx ddii ddiissccuussssiioonnee GGlliibbcc 22
        Questa lista  intesa per le discussioni tra utenti Linux che
        hanno installato glibc 2, le nuove librerie GNU C. Argomenti
        riguardano problemi di compatibilit e questioni relative la
        compilazione del codice in ambiente Linux/glibc.  Per iscriversi
         necessario scrivere a Majordomo@ricardo.ecn.wfu.edu includendo
        come messaggio: "subscribe glibc-linux <your email address>".


  1100..22..  RRiiccoonnoosscciimmeennttii


  La maggior parte di queste informazioni  stata presa da GNU Libc web
  page <http://www.gnu.org/software/libc/libc.html>, dall'annuncio della
  glibc 2 e relativi commenti di Ulrich Drepper's
  <drepper@gnu.ai.mit.edu>.  Andreas Jaeger <aj@arthur.rhein-neckar.de>
  ha fornito parte della sezione riguardo la segnalazione di bug.

  Le seguenti persone hanno fornito segnalazioni ed informazioni su
  questo documento:

    Allex <allex@ms2.accmail.com.tw>

    Mark Brown <M.A.Brown-4@sms.ed.ac.uk>

    Ulrich Drepper <drepper@gnu.ai.mit.edu>

    Scott K. Ellis <ellis@valueweb.net>

    Aron Griffis <agriffis@coat.com>

    Andreas Jaeger <aj@arthur.rhein-neckar.de>

    Frodo Looijaard <frodol@dds.nl>

    Ryan McGuire <rmcguire@freenet.columbus.oh.us>

    Shaya Potter <spotter@capaccess.org>

    Les Schaffer <godzilla@futuris.net>

    Andy Sewell <puck@pookhill.demon.co.uk>

    Gary Shea <shea@gtsdesign.com>

    Stephane <sr@adb.fr>

    Jan Vandenbos <jan@imaxx.net>

  Traduzioni di questo documento sono fatte da:

    Cinese: Allex <allex@ms2.accmail.com.tw>

    Francese:  Olivier Tharan <tharan@int-evry.fr>

    Italiano:  Andrea Girotto <andrea.girotto@usa.net>

    Japanese:  Kazuyuki Okamoto <ikko-@pacific.rim.or.jp>



  1100..33..  SSeeggnnaallaazziioonnii..


  A parte la scrittura di questo HOWTO, la manutenzione della pagina
  glibc 2 for Linux <http://www.imaxx.net/~thrytis/glibc> e l'uso sulla
  propria macchina, l'autore non ha nulla a che fare con il progetto
  glibc.  Ogni segnalazione, correzione o proposta sar ben accetta,
  scrivendo a ejg3@cornell.edu <mailto:ejg3@cornell.edu>.


  1100..44..  CCooppyyrriigghhtt..

  Copyright (c) 1997 Eric Green.  Questo documento pu essere
  distribuito esclusivamente nei termini posti dalla licenza LDP.



