1. INTRODUZIONE Wine � un programma che permette di eseguire programmi sviluppati per Microsoft Windows (compresi eseguibili DOS, Windows 3.x e Win32) su Unix. E' costituito da un caricatore di programma che carica ed esegue codice binario Microsoft Windows, ed una libreria (chiamata Winelib) che implementa le chiamate alle API Windows usando il loro equivalente Unix e X11. La libreria pu� essere usata anche per portare codice Win32 in eseguibili Unix nativi. Wine � un free software, rilasciato sotto GNU LGPL; leggi il file LICENSE per i dettagli. 2. QUICK START Ogni volta che si compila dal sorgente, � raccomandabile usare il Wine installer per compilare e installare Wine. Dalla directory di livello pi� alto del sorgente Wine (che contiene questo file), esegui: ./tools/wineinstall Esegui i programmi con "wine [opzioni] programma". Per altre informazioni e risoluzione di problemi, leggi il resto di questo file, la pagina Wine man, i file nella directory documentazione del sorgente Wine (leggi "DOCUMENTATION"), ed in modo particolare la notevole quantit� di informazioni che puoi trovare a http://www.winehq.com. 3. RICHIESTE DI SISTEMA Per compilare ed eseguire Wine, devi avere uno dei seguenti: Linux versione 2.0.36 o superiore FreeBSD 4.x o FreeBSD 5-CORRENTE o superiore Solaris x86 2.5 o superiore NetBSD-CORRENTE poich� Wine richiede il supporto al Kernel-level thread per essere eseguito, solo i sistemi operativi sopra menzionati sono supportati. Altri sistemi operativi che supportano i kernel threads potranno essere supportati in futuro. Informazioni Linux: Mentre Linux 2.2.x dovrebbe funzionare, Linux 2.0.x potrebbe funzionare (versioni pi� vecchie della 2.0.x avevano crash collegati ai thread), � consigliabile quindi avere una versione corrente del Kernel come la 2.4.x. Informazioni FreeBSD: Assicurati che le opzioni USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG siano attive nel tuo Kernel. Altre informazioni si trovano nel ports tree: ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/ Informazioni Solaris: Sar� necessario compilare Wine con l'insieme di tool GNU (gcc, gas, etc.). Attenzione : installare gas *non* significa che questo sar� usato da gcc. E' necessario ricompilare gcc dopo aver installato gas o symblinking cc, cos� come lo � per ld delle gnu tools. Informazioni NetBSD: Assicurati che le opzioni USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG siano attive nel tuo Kernel. File System supportati: Wine dovrebbe poter essere eseguito sulla maggioranza dei file system. Tuttavia, Wine potrebbe non partire se umsdos � usato per la directory /tmp. Alcuni problemi di compatibilit� sono stati riportati usando l'accesso ai file attraverso Samba. Inoltre, poich� NTFS pu� essere usato in maniera sicura solo con accesso di sola lettura per ora, sconsigliamo l'utilizzo del NTFS, poich� i programmi Windows hanno bisogno di avere accesso in scrittura ovunque. Nel caso di file NTFS, questi vanno copiati in una locazione nella quale si ha accesso in scrittura. Requisiti base: Deve essere installato anche l'X11 development inclusi i file (chiamato xlib6g-dev in Debian e Xfree86-devel in RedHat). Tool di compilazione necessari: Su sistemi x86 � richiesta una versione gcc >= a 2.7.2. Versioni pi� vecchie potrebbero avere dei problemi quando alcuni file vengono compilati con l'ottimizzazione, a causa di problemi con la gestione degli header dei file. Pgcc al momento non funziona con Wine. La causa di questo problema � sconosciuta. Chiaramente � necessario anche "make" (pi� precisamente GNU make). E' necessario anche flex versione 2.5 o successiva e yacc. Bison pu� essere utilizzato al posto di yacc. Se stai usando una RedHat o Debian, installa i pacchetti Flex e Bison. Librerie per supporti opzionali: Se vuoi il supporto alla stampa CUPS, installa i pacchetti sia cups che cups-devel. Per l'esecuzione automatica della suite di script test, avrai bisogno del supporto della Libperl development header (pacchetto libperl-dev su Debian). Nel caso in cui volessi compilare la documentazione da solo, leggi la sezione "DOCUMENTAZIONE". 4. COMPILAZIONE Nel caso in cui si scegliesse di non utilizzare Wineinstall, esegui i seguenti comandi per compilare Wine: ./configure make depend make Questo compiler� il programma "wine" e numerose librerie e binari di supporto. Il progrmma "wine" carica ed esegue gli eseguibili Windows. La libreria "libwine" ("Winelib") pu� essere usata per compilare e linkare il codice sorgente Windows sotto Unix. Per vedere le opzioni della configurazione della compilazione, esegui ./configure -help. Per fare l'upgrade ad una nuova versione utilizzando una patch, prima cd fino alla directory di livello superiore della release (quella che contiene questo file README). Quindi esegui "make clean", ed applica la patch alla release con: Gunzip -c patch-file | patch -p1 dove "patch-file" � il nome della patch (qualcosa come Wine-aammgg.diff.gz). Puoi quindi rieseguire "./configure", e quindi eseguire "make depend && make". 5. SETUP Una volta che Wine � stato compilato correttamente, puoi eseguire "make install"; questo installer� gli eseguibili wine, la pagina Wine man, e altri pochi file necessari. Non scordarti di disinstallare qualsiasi precedente installazione di Wine in conflitto. Prova sia "dpkg -r wine" o "rpm -e wine" o "make uninstall" prima di installare. Se vuoi leggere la documentazione fornita con il sorgente Wine, controlla la sezione "DOCUMENTAZIONE". Wine ha bisogno di un file di configurazione chiamato "config" nella tua directory ~/.wine. Il formato di questo file � spiegato nella pagina config file man (documentation/wine.conf.man). Il file documentation/samples/config contiene un esempio di file di configurazione che deve essere adattato e copiato nella locazione menzionata in precedenza. Non scordarti di aggiungere chiavi di registro vitali applicando winedefault.reg con programs/regedit/. Controlla la directory documentation/ per i dettagli. Controlla l'area Support a http://www.winehq.com/ per altri suggerimenti sulla configurazione. Nel caso di errori di caricamento delle librerie (e.g. "Error while loading shared libraries: libntdll.so"), accertati di aggiungere il percorso della directory a /etc/ld.so.conf ed esegui ldconfig come root. Per verificare la correttezza dell'ambiente di cui hai bisogno per eseguire Wine con successo, puoi eseguire "./tools/winecheck | less". Otterrai un punteggio percentuale che indica la "Correttezza della configurazione di Wine". poich� questo programma � una alpha, anche se non esegue un vero test completo ancora, pu� essere utilizzato come un primo step di verifica. Controlla la pagina wine.conf man su come passare alla modalit� solo testuale se lo desideri. 6. ESEGUIRE I PROGRAMMI Quando si esegue Wine, si pu� specificare l'intero percorso dell'eseguibile o solo il nome del file. Per esempio: per eseguire Solitario: Wine sol (Utilizzando il percorso di ricerca come specificato Wine sol.exe nel file di configurazione per localizzare il file) wine c:\\windows\\sol.exe (utilizzando la sintassi DOS) wine /usr/windows/sol.exe (utilizzando la sintassi Unix) wine - sol.exe /parameter1 -parameter2 parameter3 (chiama il programma con dei parametri) Nota: il percorso del file pu� essere aggiunto al percorso quando � fornito un nome intero sulla commandline. Wine non � ancora completo, quindi molti programmi potrebbero crashare. Se winedbg � settato correttamente in accordo con la documentazione contenuta in documentation/debugger.sgml, sarai mandato all'interno di un debugger cos� potrai studiare e risolvere il problema. Per maggiori informazioni su come fare ci�, per favore leggi il file documentation/debugging.sgml. Dovresti fare un backup di tutti i tuoi file importanti ai quali concedi l'accesso da parte di Wine, oppure creane una speciale copia Wine, poich� si sono verificati dei casi di utenti che hanno riportato la corruzione di file. NON eseguire Explorer, ad esempio, se non hai un backup appropriato, perch� a volte rinomina/storpia diverse directory. Anche altre applicazioni MS non sono sicure come ad esempio Messenger, visto che lanciano Explorer in un modo o nell'altro. Queste particolari corruzioni (!$!$!$!$.pfr) possono essere parzialmente corrette utilizzando http://home.nexgo.de/andi.mohr/download/decorrupt_explorer 7. DOCUMENTAZIONE Puoi trovare della documentazione (diverse guide per Wine etc.) nella directory documentation/ (a parte quelle disponibili su Winehq). Se vuoi processare i file SGML, puoi eseguire "make doc" nella directory documentation/. Per fare ci� � richiesto il pacchetto di tool sgml (per db2html, db2ps, db2pdf) chiamati: Debian: docbook-utils Mandrake: sgml-tools-A.B.C-DDmdk Suse: docbktls-A.BB.C-DD 8. PER OTTENERE PIU' INFORMAZIONI WWW: Un gran quantitativo di informazioni messe a disposizione da WineHQ su Wine � disponibile all'indirizzo http://www.winehq.com/: varie guide a Wine, database, identificazione di bug. Questo � probabilmente il miglior punto di partenza. FAQ: Le FAQ di Wine si trovano all'indirizzo http://www.winehq.com/FAQ Usenet: Puoi discutere di argomenti collegati a Wine ed ottenere aiuto su comp.emulators.ms-windows.wine. Bugs: Riporta i Bug a Wine Bugzilla a http://bugs.winehq.com per favore cerca nel database di bugzilla per verificare che il tuo problema non sia gi� stato trovato prima di postare un rapporto su un bug. Puoi anche postare i rapporti sui bug a comp.emulators.ms-windows.wine. Per favore leggi il file documentation/bugs.sgml per verificare quali informazioni sono richieste. IRC: Aiuto online � disponibile nel canale #Winehq su irc.freenode.net. CVS: Il tree di sviluppo corrente di wine e' disponibile in CVS. Visita http://www.winehq.com/cvs per altre informazioni. Mailing list: Esistono diverse mailing list per gli sviluppatori di Wine; visita http://www.winehq.com/forums per ulteriori informazioni. Se aggiungi qualcosa, o correggi un bug, per favore manda una patch (nel formato 'diff -u') a wine-patches@winehq.com per essere incluso nella prossima release. -- Alexandre Julliard julliard@winehq.com tradotto da: Francesco Di Punzio francesco_dipunzio@virgilio.it se trovi errori nella traduzione per favore segnalali tramite e-mail. Grazie