blob: d3fe546fa4a4364638e9c999d246acf668a39e50 [file] [log] [blame]
Francesco Di Punzio3421d522003-05-20 02:16:17 +000011. INTRODUZIONE
2
Luca Bennati6c73daa2012-02-28 16:15:18 +01003Wine è un programma che permette di eseguire programmi sviluppati per
4Microsoft Windows (compresi eseguibili DOS, Windows 3.x, Win32, and
5Win64) on Unix. Consiste di un caricatore di programmi che carica ed
6esegue un binario Microsoft Windows, e di una libreria (chiamata Winelib)
7che implementa le chiamate alle API Windows usando i loro equivalenti
8Unix o X11. La libreria può essere usata anche per portare codice Windows
9in eseguibili nativi Unix.
10
11Wine è un software libero, rilasciato sotto la GNU LGPL; leggere il file
12LICENSE per maggiori dettagli.
13
Francesco Di Punzio3421d522003-05-20 02:16:17 +000014
152. QUICK START
16
Luca Bennati6c73daa2012-02-28 16:15:18 +010017Compilando da sorgente, si raccomanda di usare l'Installer di Wine per
18compilare ed installare Wine. Dalla cartella principale del sorgente di
19Wine, eseguire:
Francesco Di Punzio3421d522003-05-20 02:16:17 +000020
21./tools/wineinstall
22
Luca Bennati6c73daa2012-02-28 16:15:18 +010023Eseguire i programmi com "wine programma". Per maggiori informazioni e
24risoluzioni di problemi, leggere il resto di questo file, la pagina man
25di Wine, ed in modo particolare la notevole quantità di informazioni che
26si trova all'indirizzo http://www.winehq.org.
Francesco Di Punzio3421d522003-05-20 02:16:17 +000027
Francesco Di Punzio3421d522003-05-20 02:16:17 +000028
Luca Bennati6c73daa2012-02-28 16:15:18 +0100293. REQUISITI
30
31Per compilare ed eseguire Wine, è necessario avere uno dei seguenti sistemi:
Francesco Di Punzio3421d522003-05-20 02:16:17 +000032
Luca Bennatie5432d02010-07-14 11:51:51 +020033 Linux versione 2.0.36 o successiva
Luca Bennati6c73daa2012-02-28 16:15:18 +010034 FreeBSD 7.0 o successiva
Luca Bennatie5432d02010-07-14 11:51:51 +020035 Solaris x86 9 o successiva
Luca Bennati6c73daa2012-02-28 16:15:18 +010036 NetBSD-current
Luca Bennatie5432d02010-07-14 11:51:51 +020037 Mac OS X 10.4 o successiva
Francesco Di Punzio3421d522003-05-20 02:16:17 +000038
Luca Bennati6c73daa2012-02-28 16:15:18 +010039Poiché Wine richiede il supporto dei thread a livello kernel per funzionare,
40solo i sistemi operativi sopra mentionati sono supportati. Altri sistemi
41che forniscono kernel threads potrebbero essere supportati in futuro.
Francesco Di Punzio3421d522003-05-20 02:16:17 +000042
Luca Bennati6c73daa2012-02-28 16:15:18 +010043Informazioni per FreeBSD:
44 In generale Wine non funzionerà correttamente con versioni precedenti
45 a FreeBSD 7.0.
46 Leggere http://wiki.freebsd.org/Wine per maggiori informazioni.
Francesco Di Punzio3421d522003-05-20 02:16:17 +000047
Luca Bennati6c73daa2012-02-28 16:15:18 +010048Informazioni per Solaris:
49 Sarà molto probabilmente necessario compilare Wine con i tool GNU
50 (gcc, gas, etc). Attenzione: installare gas *non* assicura che
51 sia usato da gcc. Sembra che sia necessario ricompilare gcc dopo
52 l'installazione di gas o il symlink di cc, as e ld per i tool GNU.
Francesco Di Punzio3421d522003-05-20 02:16:17 +000053
Luca Bennati6c73daa2012-02-28 16:15:18 +010054Informazioni per NetBSD:
55 Assicurarsi che le opzioni USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG siano
56 abilitate nel kernel.
Francesco Di Punzio3421d522003-05-20 02:16:17 +000057
Luca Bennati6c73daa2012-02-28 16:15:18 +010058Informazioni per Mac OS X:
59 È richiesto Xcode 2.4 o superiore per compilare correttamente su x86.
Francesco Di Punzio3421d522003-05-20 02:16:17 +000060
Francesco Di Punzio3421d522003-05-20 02:16:17 +000061
Luca Bennati6c73daa2012-02-28 16:15:18 +010062File system supportati:
63 Wine dovrebbe funzionare sulla maggior parte dei file system. Qualche
Luca Bennatie5432d02010-07-14 11:51:51 +020064 problema di compatibilità è stato riportato usando file acceduti
Luca Bennati6c73daa2012-02-28 16:15:18 +010065 tramite Samba. Inoltre, NTFS non fornisce tutte le funzionalità di
66 file system necessarie per alcune applicazioni. Si raccomanda di usare
67 un file system nativo di Unix.
Francesco Di Punzio3421d522003-05-20 02:16:17 +000068
Luca Bennati6c73daa2012-02-28 16:15:18 +010069Requisiti basilari:
70 Devono essere installati i file include di sviluppo di X11
71 (chiamato xlib6g-dev in Debian e XFree86-devel in Red Hat).
Francesco Di Punzio3421d522003-05-20 02:16:17 +000072
Luca Bennati6c73daa2012-02-28 16:15:18 +010073 Ovviamente necessario anche "make" (possibilmente GNU make).
Francesco Di Punzio3421d522003-05-20 02:16:17 +000074
Luca Bennati6c73daa2012-02-28 16:15:18 +010075 È richiesto anche flex versione 2.5.33 o superiore e bison.
Francesco Di Punzio3421d522003-05-20 02:16:17 +000076
Luca Bennati6c73daa2012-02-28 16:15:18 +010077Librerie opzionali di supporto:
78 Configure notificherà a video quando le librerie opzionali non sono
79 trovate sul sistema. Leggere http://wiki.winehq.org/Recommended_Packages
80 per suggerimenti sui pacchetti da installare.
Francesco Di Punzio3421d522003-05-20 02:16:17 +000081
Luca Bennati6c73daa2012-02-28 16:15:18 +010082 Su piattaforme a 64-bit, per compilare Wine a 32-bit (predefinito),
83 assicurarsi di installare la versione a 32-bit di queste librerie;
84 leggere http://wiki.winehq.org/WineOn64bit per i dettagli. Per avere
85 Wine solo 64-bit (o un setup di Wine misto tra 32-bit e 64-bit),
86 leggere http://wiki.winehq.org/Wine64 per maggiori informazioni.
87
Francesco Di Punzio3421d522003-05-20 02:16:17 +000088
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000894. COMPILAZIONE
90
Luca Bennati6c73daa2012-02-28 16:15:18 +010091Nel caso in cui si scegliesse di non utilizzare wineinstall, eseguire
92i seguenti comandi per compilare Wine:
Francesco Di Punzio3421d522003-05-20 02:16:17 +000093
94./configure
Francesco Di Punzio3421d522003-05-20 02:16:17 +000095make
96
Luca Bennati6c73daa2012-02-28 16:15:18 +010097Questa sequenza compilerà il programma "wine" e numerose librerie e
98binari di supporto.
99Il programma "wine" caricherà ed eseguirà eseguibili Windows.
100La libreria "libwine" ("Winelib") può essere usata per compilare e
101linkare codice sorgente Windows sotto Unix.
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000102
Luca Bennati6c73daa2012-02-28 16:15:18 +0100103Per vedere le opzioni di configurazione della compilazione, eseguire
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000104./configure -help.
105
Francesco Di Punzio3421d522003-05-20 02:16:17 +00001065. SETUP
107
Luca Bennatie5432d02010-07-14 11:51:51 +0200108Una volta che Wine è stato compilato correttamente, puoi eseguire
Luca Bennati6c73daa2012-02-28 16:15:18 +0100109"make install"; questo installerà l'eseguibile wine, le librerie, la
110pagina man di Wine, e altri file necessari.
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000111
Luca Bennati6c73daa2012-02-28 16:15:18 +0100112Non dimenticarti di disinstallare qualsiasi precedente installazione
113di Wine in conflitto. Prova sia "dpkg -r wine" o "rpm -e wine" o
114"make uninstall" prima di installare.
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000115
Luca Bennati6c73daa2012-02-28 16:15:18 +0100116Una volta installato, esegui lo strumento di configurazione "winecfg".
117Leggi l'area Support su http://www.winehq.org/ per suggerimenti sulla
118configurazione.
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000119
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000120
Luca Bennati6c73daa2012-02-28 16:15:18 +01001216. ESEGUIRE PROGRAMMI
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000122
Luca Bennati6c73daa2012-02-28 16:15:18 +0100123Quando si esegue Wine, si può specificare l'intero percorso
124dell'eseguibile o solo il nome del file.
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000125
Luca Bennati6c73daa2012-02-28 16:15:18 +0100126Per esempio, per eseguire Blocco Note:
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000127
Luca Bennati6c73daa2012-02-28 16:15:18 +0100128 wine notepad (usando il percorso di ricerca come specificato
129 wine notepad.exe nel registro per trovare il file)
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000130
Luca Bennati6c73daa2012-02-28 16:15:18 +0100131 wine c:\\windows\\notepad.exe (usando la sintassi DOS)
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000132
Luca Bennati6c73daa2012-02-28 16:15:18 +0100133 wine ~/.wine/drive_c/windows/notepad.exe (usando la sintassi Unix)
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000134
Luca Bennati6c73daa2012-02-28 16:15:18 +0100135 wine notepad.exe readme.txt (chiamando il programma con dei parametri)
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000136
Luca Bennati6c73daa2012-02-28 16:15:18 +0100137Wine non è perfetto, quindi alcuni programmi potrebbero andare in crash.
138Se ciò accadesse, sarà creato un log del crash da aggiungere al rapporto
139di segnalazione del problema.
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000140
Luca Bennati6c73daa2012-02-28 16:15:18 +0100141
1427. PER OTTENERE PIÙ INFORMAZIONI
143
144WWW: Un gran quantitativo di informazioni su Wine è disponibile al
145 WineHQ, http://www.winehq.org/: varie guide su Wine, database
146 delle applicazioni, rintracciamento di bug. Questo è probabilmente
147 il miglior punto di partenza.
148
149FAQ: Le FAQ di Wine si trovano all'indirizzo http://www.winehq.org/FAQ
150
151Wiki: Il Wiki di Wine si trova all'indirizzo http://wiki.winehq.org
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000152
Ivan Leo Murray-Smithbbf48a12004-01-20 21:50:21 +0000153Mailing list:
Luca Bennati6c73daa2012-02-28 16:15:18 +0100154 Esistono diverse mailing list per utenti e sviluppatori di Wine;
155 visitare http://www.winehq.org/forums per ulteriori informazioni.
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000156
Luca Bennati6c73daa2012-02-28 16:15:18 +0100157Bugs: Segnalare i bug su Wine Bugzilla all'indirizzo http://bugs.winehq.org
158 Si prega di controllare il database di Bugzilla per verificare che
159 il problema non sia già conosciuto o risolto prima di creare un
160 rapporto su di esso.
Luca Bennatie5432d02010-07-14 11:51:51 +0200161
Luca Bennati6c73daa2012-02-28 16:15:18 +0100162IRC: Aiuto online disponibile nel canale #WineHQ su irc.freenode.net.
Luca Bennatie5432d02010-07-14 11:51:51 +0200163
Luca Bennati6c73daa2012-02-28 16:15:18 +0100164Git: L'albero attuale di sviluppo di Wine è disponibile attraverso Git.
165 Vedere http://www.winehq.org/git per maggiori informazioni.
Luca Bennatie5432d02010-07-14 11:51:51 +0200166
Luca Bennati6c73daa2012-02-28 16:15:18 +0100167Se aggiungi qualcosa, o correggi un bug, si prega di mandare una patch
168(preferibilmente usando git-format-patch) alla mailing list
169wine-patches@winehq.org per l'inclusione nel prossimo rilascio.
Francesco Di Punzio3421d522003-05-20 02:16:17 +0000170
171--
172Alexandre Julliard
Dimitrie O. Paunc0232542003-11-26 03:55:01 +0000173julliard@winehq.org