documentation/README.it

   1 1. INTRODUZIONE
   2
   3 Wine è un programma che permette di eseguire programmi sviluppati per Microsoft
   4 Windows (compresi eseguibili DOS, Windows 3.x e Win32) su Unix. E' costituito
   5 da un caricatore di programma che carica ed esegue codice binario Microsoft
   6 Windows, ed una libreria (chiamata Winelib) che implementa le chiamate alle API
   7 Windows usando il loro equivalente Unix e X11. La libreria può essere usata
   8 anche per portare codice Win32 in eseguibili Unix nativi.
   9 Wine è un free software, rilasciato sotto GNU LGPL; leggi il file LICENSE per i
  10 dettagli.
  11
  12 2. QUICK START
  13
  14 Ogni volta che si compila dal sorgente, è raccomandabile usare il Wine installer
  15 per compilare e installare Wine. Dalla directory di livello più alto del
  16 sorgente Wine (che contiene questo file), esegui:
  17
  18 ./tools/wineinstall
  19
  20 Esegui i programmi con "wine [opzioni] programma". Per altre informazioni e
  21 risoluzione di problemi, leggi il resto di questo file, la pagina Wine man, i
  22 file nella directory documentazione del sorgente Wine (leggi "DOCUMENTATION"),
  23 ed in modo particolare la notevole quantità di informazioni che puoi trovare a
  24 http://www.winehq.org.
  25
  26 3. RICHIESTE DI SISTEMA
  27
  28 Per compilare ed eseguire Wine, devi avere uno dei seguenti:
  29
  30         Linux versione 2.0.36 o superiore
  31         FreeBSD 4.x o FreeBSD 5-CORRENTE o superiore
  32         Solaris x86 2.5 o superiore
  33         NetBSD-CORRENTE
  34
  35 poiché Wine richiede il supporto al Kernel-level thread per essere eseguito,
  36 solo i sistemi operativi sopra menzionati sono supportati.
  37 Altri sistemi operativi che supportano i kernel threads potranno essere
  38 supportati in futuro.
  39
  40 Informazioni Linux:
  41
  42 Mentre Linux 2.2.x dovrebbe funzionare, Linux 2.0.x potrebbe funzionare
  43 (versioni più vecchie della 2.0.x avevano crash collegati ai thread), è
  44 consigliabile quindi avere una versione corrente del Kernel come la 2.4.x.
  45
  46 Informazioni FreeBSD:
  47
  48 Assicurati che le opzioni USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG siano attive nel
  49 tuo Kernel. Altre informazioni si trovano nel ports tree:
  50 ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/
  51
  52 Informazioni Solaris:
  53
  54 Sarà necessario compilare Wine con l'insieme di tool GNU (gcc, gas, etc.).
  55 Attenzione : installare gas *non* significa che questo sarà usato da gcc.
  56 E' necessario ricompilare gcc dopo aver installato gas o symblinking cc, così
  57 come lo è per ld delle gnu tools.
  58
  59 Informazioni NetBSD:
  60
  61 Assicurati che le opzioni USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG siano attive nel
  62 tuo Kernel.
  63
  64 File System supportati:
  65 Wine dovrebbe poter essere eseguito sulla maggioranza dei file system. Tuttavia,
  66 Wine potrebbe non partire se umsdos è usato per la directory /tmp. Alcuni
  67 problemi di compatibilità sono stati riportati usando l'accesso ai file
  68 attraverso Samba. Inoltre, poiché NTFS può essere usato in maniera sicura solo
  69 con accesso di sola lettura per ora, sconsigliamo l'utilizzo del NTFS, poiché i
  70 programmi Windows hanno bisogno di avere accesso in scrittura ovunque.
  71 Nel caso  di file NTFS, questi vanno copiati in una locazione nella quale si ha
  72 accesso in scrittura.
  73
  74 Requisiti base:
  75
  76 Deve essere installato anche l'X11 development inclusi i file (chiamato
  77 xlib6g-dev in Debian e Xfree86-devel in RedHat).
  78
  79 Tool di compilazione necessari:
  80
  81 Su sistemi x86 è richiesta una versione gcc >= a 2.7.2.
  82 Versioni più vecchie potrebbero avere dei problemi quando alcuni file vengono
  83 compilati con l'ottimizzazione, a causa di problemi con la gestione degli header
  84 dei file. Pgcc al momento non funziona con Wine. La causa di questo problema
  85 è sconosciuta.
  86
  87 Chiaramente è necessario anche "make" (più precisamente GNU make).
  88
  89 E' necessario anche flex versione 2.5 o successiva e yacc.
  90 Bison può essere utilizzato al posto di yacc. Se stai usando una RedHat o
  91 Debian, installa i pacchetti Flex e Bison.
  92
  93 Librerie per supporti opzionali:
  94
  95 Se vuoi il supporto alla stampa CUPS, installa i pacchetti sia cups che
  96 cups-devel.
  97
  98 Per l'esecuzione automatica della suite di script test, avrai bisogno del
  99 supporto della Libperl development header (pacchetto libperl-dev su Debian).
 100
 101 Nel caso in cui volessi compilare la documentazione da solo, leggi la sezione
 102 "DOCUMENTAZIONE".
 103
 104 4. COMPILAZIONE
 105
 106 Nel caso in cui si scegliesse di non utilizzare Wineinstall, esegui i seguenti
 107 comandi per compilare Wine:
 108
 109 ./configure
 110 make depend
 111 make
 112
 113 Questo compilerà il programma "wine" e numerose librerie e binari di supporto.
 114 Il progrmma "wine" carica ed esegue gli eseguibili Windows.
 115 La libreria "libwine" ("Winelib") può essere usata per compilare e linkare il
 116 codice sorgente Windows sotto Unix.
 117
 118 Per vedere le opzioni della configurazione della compilazione, esegui
 119 ./configure -help.
 120
 121 Per fare l'upgrade ad una nuova versione utilizzando una patch, prima cd fino
 122 alla directory di livello superiore della release (quella che contiene questo
 123 file README). Quindi esegui "make clean", ed applica la patch alla release con:
 124
 125         Gunzip -c patch-file | patch -p1
 126
 127 dove "patch-file" è il nome della patch (qualcosa come Wine-aammgg.diff.gz).
 128 Puoi quindi rieseguire "./configure", e quindi eseguire "make depend && make".
 129
 130 5. SETUP
 131
 132 Una volta che Wine è stato compilato correttamente, puoi eseguire
 133 "make install"; questo installerà gli eseguibili wine, la pagina Wine man, e
 134 altri pochi file necessari.
 135
 136 Non scordarti di disinstallare qualsiasi precedente installazione di Wine in
 137 conflitto. Prova sia "dpkg -r wine" o "rpm -e wine" o "make uninstall" prima di
 138 installare.
 139
 140 Se vuoi leggere la documentazione fornita con il sorgente Wine, controlla la
 141 sezione "DOCUMENTAZIONE".
 142
 143 Wine ha bisogno di un file di configurazione chiamato "config" nella tua
 144 directory ~/.wine. Il formato di questo file è spiegato nella pagina config file
 145 man (documentation/wine.conf.man).
 146 Il file documentation/samples/config contiene un esempio di file di
 147 configurazione che deve essere adattato e copiato nella locazione menzionata in
 148 precedenza.
 149
 150 Non scordarti di aggiungere chiavi di registro vitali applicando winedefault.reg
 151 con programs/regedit/. Controlla la directory documentation/ per i dettagli.
 152
 153 Controlla l'area Support a http://www.winehq.org/ per altri suggerimenti sulla
 154 configurazione.
 155
 156 Nel caso di errori di caricamento delle librerie
 157 (e.g. "Error while loading shared libraries: libntdll.so"), accertati di
 158 aggiungere il percorso della directory a /etc/ld.so.conf ed esegui ldconfig come
 159 root.
 160
 161 Per verificare la correttezza dell'ambiente di cui hai bisogno per eseguire Wine
 162 con successo, puoi eseguire "./tools/winecheck | less".
 163 Otterrai un punteggio percentuale che indica la "Correttezza della
 164 configurazione di Wine".
 165 poiché questo programma è una alpha, anche se non esegue un vero test completo
 166 ancora, può essere utilizzato come un primo step di verifica.
 167
 168 Controlla la pagina wine.conf man su come passare alla modalità solo testuale
 169 se lo desideri.
 170
 171 6. ESEGUIRE I PROGRAMMI
 172
 173 Quando si esegue Wine, si può specificare l'intero percorso dell'eseguibile o
 174 solo il nome del file.
 175
 176 Per esempio: per eseguire Solitario:
 177
 178         Wine sol        (Utilizzando il percorso di ricerca come specificato
 179         Wine sol.exe      nel file di configurazione per localizzare il file)
 180
 181         wine c:\\windows\\sol.exe (utilizzando la sintassi DOS)
 182         wine /usr/windows/sol.exe (utilizzando la sintassi Unix)
 183         wine - sol.exe /parameter1 -parameter2 parameter3
 184                                   (chiama il programma con dei parametri)
 185
 186 Nota: il percorso del file può essere aggiunto al percorso quando è fornito un
 187 nome intero sulla commandline.
 188
 189 Wine non è ancora completo, quindi molti programmi potrebbero crashare. Se
 190 winedbg è settato correttamente in accordo con la documentazione contenuta in
 191 documentation/debugger.sgml, sarai mandato all'interno di un debugger così
 192 potrai studiare e risolvere il problema.
 193 Per maggiori informazioni su come fare ciò, per favore leggi il file
 194 documentation/debugging.sgml.
 195
 196 Dovresti fare un backup di tutti i tuoi file importanti ai quali concedi
 197 l'accesso da parte di Wine, oppure creane una speciale copia Wine, poiché si
 198 sono verificati dei casi di utenti che hanno riportato la corruzione di file.
 199 NON eseguire Explorer, ad esempio, se non hai un backup appropriato, perché a
 200 volte rinomina/storpia diverse directory. Anche altre applicazioni MS non sono
 201 sicure come ad esempio Messenger, visto che lanciano Explorer in un modo o
 202 nell'altro. Queste particolari corruzioni (!$!$!$!$.pfr) possono essere
 203 parzialmente corrette utilizzando
 204 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
 205
 206 7. DOCUMENTAZIONE
 207
 208 Puoi trovare della documentazione (diverse guide per Wine etc.) nella directory
 209 documentation/ (a parte quelle disponibili su WineHQ).
 210
 211 Se vuoi processare i file SGML, puoi eseguire "make doc" nella directory
 212 documentation/.
 213 Per fare ciò è richiesto il pacchetto di tool sgml (per db2html, db2ps, db2pdf)
 214 chiamati:
 215
 216 Debian:         docbook-utils
 217 Mandrake:               sgml-tools-A.B.C-DDmdk
 218 SuSE:           docbktls-A.BB.C-DD
 219
 220 8. PER OTTENERE PIU' INFORMAZIONI
 221
 222 WWW: Un gran quantitativo di informazioni messe a disposizione da WineHQ su Wine
 223 è disponibile all'indirizzo http://www.winehq.org/: varie guide a Wine,
 224 database, identificazione di bug. Questo è probabilmente il miglior punto di
 225 partenza.
 226
 227 FAQ: Le FAQ di Wine si trovano all'indirizzo http://www.winehq.org/FAQ
 228
 229 Usenet: Puoi discutere di argomenti collegati a Wine ed ottenere aiuto su
 230 comp.emulators.ms-windows.wine.
 231
 232 Bugs: Riporta i Bug a Wine Bugzilla a http://bugs.winehq.org per favore cerca
 233 nel database di bugzilla per verificare che il tuo problema non sia già stato
 234 trovato prima di postare un rapporto su un bug. Puoi anche postare i rapporti
 235 sui bug a comp.emulators.ms-windows.wine. Per favore leggi il file
 236 documentation/bugs.sgml per verificare quali informazioni sono richieste.
 237
 238 IRC: Aiuto online è disponibile nel canale #WineHQ su irc.freenode.net.
 239
 240 CVS: Il tree di sviluppo corrente di wine e' disponibile in CVS. Visita
 241 http://www.winehq.org/cvs per altre informazioni.
 242
 243 Mailing list: Esistono diverse mailing list per gli sviluppatori di Wine; visita
 244 http://www.winehq.org/forums per ulteriori informazioni.
 245
 246 Se aggiungi qualcosa, o correggi un bug, per favore manda una patch (nel formato
 247 'diff -u') a wine-patches@winehq.org per essere incluso nella prossima release.
 248
 249 --
 250 Alexandre Julliard
 251 julliard@winehq.org
 252
 253 tradotto da:
 254 Francesco Di Punzio
 255 francesco_dipunzio@virgilio.it
 256 se trovi errori nella traduzione per favore segnalali tramite e-mail. Grazie