Implementation stub for QueueUserWorkItem.
[wine] / 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 principale del
16 sorgente Wine, 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 "DOCUMENTAZIONE"),
23 ed in modo particolare la notevole quantità di informazioni che puoi trovare a
24 http://www.winehq.org.
25
26 3. REQUISITI MINIMI 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 abilitate nel
49 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 abilitate nel
62 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 bison.
90 Se stai usando una RedHat o Debian, installa i pacchetti Flex e Bison.
91
92 Librerie per supporti opzionali:
93
94 Se vuoi il supporto alla stampa CUPS, installa i pacchetti sia cups che
95 cups-devel.
96
97 Nel caso in cui volessi compilare la documentazione da solo, leggi la sezione
98 "DOCUMENTAZIONE".
99
100 4. COMPILAZIONE
101
102 Nel caso in cui si scegliesse di non utilizzare Wineinstall, esegui i seguenti
103 comandi per compilare Wine:
104
105 ./configure
106 make depend
107 make
108
109 Questo compilerà il programma "wine" e numerose librerie e binari di supporto.
110 Il progrmma "wine" carica ed esegue gli eseguibili Windows.
111 La libreria "libwine" ("Winelib") può essere usata per compilare e linkare il
112 codice sorgente Windows sotto Unix.
113
114 Per vedere le opzioni della configurazione della compilazione, esegui
115 ./configure -help.
116
117 Per fare l'aggiornamento ad una nuova versione utilizzando una patch, prima entra
118 nella directory principale dei sorgenti (quella che contiene questo
119 file README). Quindi esegui "make distclean", ed applica la patch alla release con:
120
121         Gunzip -c patch-file | patch -p1
122
123 dove "patch-file" è il nome della patch (qualcosa come Wine-aammgg.diff.gz).
124 Puoi quindi rieseguire "./configure", e quindi eseguire "make depend && make".
125
126 5. SETUP
127
128 Una volta che Wine è stato compilato correttamente, puoi eseguire
129 "make install"; questo installerà gli eseguibili wine, la pagina Wine man, e
130 pochi altri file necessari.
131
132 Non dimenticarti di disinstallare qualsiasi precedente installazione di Wine in
133 conflitto. Prova sia "dpkg -r wine" o "rpm -e wine" o "make uninstall" prima di
134 installare.
135
136 Se vuoi leggere la documentazione fornita con il sorgente Wine, controlla la
137 sezione "DOCUMENTAZIONE".
138
139 Wine ha bisogno di un file di configurazione chiamato "config" nella tua
140 directory ~/.wine. Il formato di questo file è spiegato nella pagina config file
141 man (documentation/wine.conf.man).
142 Il file documentation/samples/config contiene un esempio di file di
143 configurazione che deve essere adattato e copiato nella locazione menzionata in
144 precedenza.
145
146 Controlla l'area Support su http://www.winehq.org/ per altri suggerimenti sulla
147 configurazione.
148
149 Nel caso di errori di caricamento delle librerie
150 (e.g. "Error while loading shared libraries: libntdll.so"), accertati di
151 aggiungere il percorso della directory a /etc/ld.so.conf ed esegui ldconfig come
152 root.
153
154 6. ESEGUIRE I PROGRAMMI
155
156 Quando si esegue Wine, si può specificare l'intero percorso dell'eseguibile o
157 solo il nome del file.
158
159 Per esempio: per eseguire Solitario:
160
161         wine sol        (Utilizzando il percorso di ricerca come specificato
162         wine sol.exe      nel file di configurazione per localizzare il file)
163
164         wine c:\\windows\\sol.exe (utilizzando la sintassi DOS)
165         wine /usr/windows/sol.exe (utilizzando la sintassi Unix)
166         wine sol.exe /parameter1 -parameter2 parameter3
167                                   (chiama il programma con dei parametri)
168
169 Nota: il percorso del file può essere aggiunto al percorso quando è fornito un
170 nome intero sulla commandline.
171
172 Wine non è ancora completo, quindi molti programmi potrebbero andare in crash. Se
173 winedbg è settato correttamente in accordo con la documentazione contenuta in
174 documentation/debugger.sgml, sarai mandato all'interno di un debugger così
175 potrai studiare e risolvere il problema.
176 Per maggiori informazioni su come fare ciò, per favore leggi il file
177 documentation/debugging.sgml.
178
179 Dovresti fare un backup di tutti i tuoi file importanti ai quali concedi
180 l'accesso da parte di Wine, oppure creane una speciale copia Wine, poiché si
181 sono verificati dei casi di utenti che hanno riportato la corruzione di file.
182 NON eseguire Explorer, ad esempio, se non hai un backup appropriato, perché a
183 volte rinomina/storpia diverse directory. Anche altre applicazioni MS non sono
184 sicure come ad esempio Messenger, visto che lanciano Explorer in un modo o
185 nell'altro. Queste particolari corruzioni (!$!$!$!$.pfr) possono essere
186 parzialmente corrette utilizzando
187 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
188
189 7. DOCUMENTAZIONE
190
191 Puoi trovare della documentazione (diverse guide per Wine etc.) nella directory
192 documentation/ (a parte quelle disponibili su WineHQ).
193
194 Se vuoi processare i file SGML, puoi eseguire "make doc" nella directory
195 documentation/.
196 Per fare ciò è richiesto il pacchetto di tool sgml (per db2html, db2ps, db2pdf)
197 chiamati:
198
199 Debian:         docbook-utils
200 Mandrake:       sgml-tools-A.B.C-DDmdk
201 SuSE:           docbktls-A.BB.C-DD
202
203 8. PER OTTENERE PIU' INFORMAZIONI
204
205 WWW:    Un gran quantitativo di informazioni messe a disposizione da WineHQ su Wine
206         è disponibile all'indirizzo http://www.winehq.org/: varie guide su Wine,
207         database, identificazione di bug. Questo è probabilmente il miglior punto di
208         partenza.
209
210 FAQ:    Le FAQ di Wine si trovano all'indirizzo http://www.winehq.org/FAQ
211
212 Usenet: Puoi discutere di argomenti collegati a Wine ed ottenere aiuto su
213         comp.emulators.ms-windows.wine.
214
215 Bugs:    Segnala i Bug su Wine Bugzilla all'indirizzo http://bugs.winehq.org
216         per favore cerca nel database di bugzilla per verificare che il tuo problema
217         non sia già stato trovato prima di postare un rapporto su un bug.
218         Puoi anche mandare le segnalazioni sui bug a comp.emulators.ms-windows.wine.
219         Per favore leggi il file documentation/bugs.sgml per verificare quali
220         informazioni sono richieste.
221
222 IRC:     Aiuto online è disponibile nel canale #winehq su irc.freenode.net.
223
224 CVS:    L'albero di sviluppo corrente di wine e' disponibile in CVS. Visita
225         http://www.winehq.org/cvs per ulteriori informazioni.
226
227 Mailing list:
228         Esistono diverse mailing list per gli sviluppatori di Wine; visita
229         http://www.winehq.org/forums per ulteriori informazioni.
230
231 Se aggiungi qualcosa, o correggi un bug, per favore manda una patch (nel formato
232 'diff -u') a wine-patches@winehq.org per essere farlo includere nella prossima release.
233
234 --
235 Alexandre Julliard
236 julliard@winehq.org
237
238 tradotto da:
239 Francesco Di Punzio
240 francesco_dipunzio@virgilio.it
241 se trovi errori nella traduzione per favore segnalali tramite e-mail. Grazie
242 Traduzione aggiornata il 18/01/2004 da Ivan Leo Puoti
243 Potete contatarmi all'indirizzo puoti@inwind.it