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