| blob | 0b76436599c994c35c266e3a55a7ccbada09da05 |
1 .TH WINE 1 "juillet 2013" "@PACKAGE_STRING@" "Windows sur Unix"
2 .SH NOM
3 wine \- exécuter des programmes Windows sur Unix
4 .SH SYNOPSIS
5 .B wine
6 .IR "programme " [ arguments ]
7 .br
8 .B wine --help
9 .br
10 .B wine --version
11 .PP
12 Pour des instructions sur le passage d'arguments aux programmes Windows, veuillez lire la section
13 .B
14 PROGRAMME/ARGUMENTS
15 de la page de manuel.
16 .SH DESCRIPTION
17 .B wine
18 charge et exécute le programme indiqué, qui peut être un exécutable DOS, Windows
19 3.x, Win32 ou Win64 (sur les systèmes 64 bits).
20 .PP
21 Pour déboguer wine, utilisez plutôt
22 .BR winedbg .
23 .PP
24 Pour exécuter des applications en ligne de commande (programmes Windows
25 console), préférez
26 .BR wineconsole .
27 Cela permet d'afficher la sortie dans une fenêtre séparée.
28 Si vous n'utilisez pas
29 .B wineconsole
30 pour les programmes en ligne de commande, le support console sera très limité et votre
31 programme pourrait ne pas fonctionner correctement.
32 .PP
33 Lorsque wine est invoqué avec
34 .B --help
35 ou
36 .B --version
37 pour seul argument, il
38 affichera seulement un petit message d'aide ou sa version respectivement, puis se terminera.
39 .SH PROGRAMME/ARGUMENTS
40 Le nom du programme peut être spécifié au format DOS
41 .RI ( C:\(rs\(rsWINDOWS\(rs\(rsSOL.EXE )
42 ou au format Unix
43 .RI ( /msdos/windows/sol.exe ).
44 Vous pouvez passer des arguments au programme exécuté en les ajoutant
45 à la fin de la ligne de commande invoquant
46 .B wine
47 (par exemple : \fIwine notepad C:\(rs\(rsTEMP\(rs\(rsLISEZMOI.TXT\fR).
48 Notez que vous devrez protéger les caractères spéciaux (et les espaces)
49 en utilisant un '\(rs' lorsque vous invoquez Wine depuis
50 un shell, par exemple :
51 .PP
52 wine C:\(rs\(rsProgram\(rs Files\(rs\(rsMonProg\(rs\(rstest.exe
53 .PP
54 Il peut également s'agir d'un des exécutables Windows livrés avec Wine,
55 auquel cas la spécification d'un chemin complet n'est pas obligatoire,
56 p.ex. \fIwine explorer\fR ou \fIwine notepad\fR.
57 .PP
58 .SH ENVIRONNEMENT
59 .B wine
60 passe les variables d'environnement du shell depuis lequel il
61 est lancé au processus Windows/DOS exécuté. Utilisez donc la syntaxe appropriée
62 à votre shell pour déclarer les variables d'environnement dont vous avez besoin.
63 .TP
64 .B WINEPREFIX
65 Si définie, le contenu de cette variable est pris comme le nom du répertoire où
66 Wine stocke ses données (la valeur par défaut est
67 .IR $HOME/.wine ).
68 Ce répertoire est également utilisé pour identifier le socket utilisé pour
69 communiquer avec
70 .BR wineserver .
71 Tous les processus
72 .B wine
73 utilisant le même
74 .B wineserver
75 (c'est-à-dire le même utilisateur) partagent certains éléments comme la base de registre,
76 la mémoire partagée et les objets du noyau.
77 En donnant à
78 .B WINEPREFIX
79 une valeur spécifique pour différents processus
80 .BR wine ,
81 il est possible d'exécuter plusieurs sessions de
82 .B wine
83 totalement indépendantes.
84 .TP
85 .B WINESERVER
86 Spécifie le chemin et le nom de l'exécutable
87 .BR wineserver .
88 Si cette variable n'est pas définie, Wine essaiera de charger un
89 fichier nommé « wineserver » dans le chemin système ou quelques autres
90 emplacements potentiels.
91 .TP
92 .B WINELOADER
93 Spécifie le chemin et le nom de l'exécutable
94 .B wine
95 à utiliser pour exécuter de nouveaux processus Windows. A défaut, Wine
96 essaiera de charger un fichier nommé « wine » dans le chemin système
97 ou quelques autres emplacements potentiels.
98 .TP
99 .B WINEDEBUG
100 Active ou désactive les messages de débogage. La syntaxe est :
101 .RI [ classe ][\fB+\fR|\fB-\fR] canal [,[ classe2 ][\fB+\fR|\fB-\fR] canal2 ]
102 .RS +7
103 .PP
104 La
105 .I classe
106 est optionnelle et peut avoir une des valeurs suivantes :
107 .BR err ,
108 .BR warn ,
109 .B fixme
110 ou
111 .BR trace .
112 Si elle n'est pas spécifiée, tous les messages de débogage pour le canal
113 associé seront activés. Chaque canal imprimera des messages à propos
114 d'un composant particulier de Wine.
115 Le caractère suivant peut être \fB+\fR ou \fB-\fR pour activer/désactiver
116 le canal spécifié. Si aucune
117 .I classe
118 n'est spécifiée, le caractère \fB+\fR peut être omis. Notez que les espaces ne sont pas
119 autorisées dans cette chaîne de caractères.
120 .PP
121 Exemples :
122 .TP
123 WINEDEBUG=warn+all
124 activera tous les messages d'avertissement (recommandé pour le débogage).
125 .br
126 .TP
127 WINEDEBUG=warn+dll,+heap
128 activera tous messages d'avertissement sur les DLL, et tous les messages sur le tas.
129 .br
130 .TP
131 WINEDEBUG=fixme-all,warn+cursor,+relay
132 désactivera tous les messages FIXME, activera les messages d'avertissement sur le composant cursor et
133 activera tous les messages du canal relay (appels de l'API).
134 .br
135 .TP
136 WINEDEBUG=relay
137 activera tous les messages du canal relay. Pour un contrôle plus fin sur l'inclusion et
138 l'exclusion des fonctions et DLL des traces relay, utilisez la clé
139 .B HKEY_CURRENT_USER\\\\Software\\\\Wine\\\\Debug
140 de la base de registre.
141 .PP
142 Pour plus d'informations sur les messages de débogage, référez-vous au chapitre
143 .I Exécution de Wine
144 du guide de l'utilisateur de Wine.
145 .RE
146 .TP
147 .B WINEDLLPATH
148 Spécifie le(s) chemin(s) où chercher les DLL intégrées et les applications
149 Winelib. C'est une liste de répertoires séparés par des « : ». En plus des
150 répertoires spécifiés dans
151 .BR WINEDLLPATH ,
152 Wine utilisera aussi le répertoire d'installation.
153 .TP
154 .B WINEDLLOVERRIDES
155 Définit le type de remplacement et l'ordre de chargement des DLL utilisées lors du
156 processus de chargement d'une DLL. Deux types de bibliothèques peuvent actuellement
157 être chargés dans l'espace d'adressage d'un processus : les DLL natives de
158 Windows
159 .RI ( native ") et les DLL intégrées à Wine (" builtin ).
160 Le type peut être abrégé avec la première lettre du type
161 .RI ( n " ou " b ).
162 La bibliothèque peut également être désactivée (''). Les séquences d'ordres
163 doivent être séparées par des virgules.
164 .RS
165 .PP
166 Chaque DLL peut avoir son ordre de chargement propre. L'ordre de chargement
167 détermine quelle version de la DLL doit être chargée dans l'espace
168 d'adressage. Si la première tentative échoue, la suivante est essayée et
169 ainsi de suite. Plusieurs bibliothèques avec le même ordre de chargement
170 peuvent être séparées par des virgules. Il est également possible de spécifier
171 différents ordres de chargements pour différentes bibliothèques en séparant les
172 entrées par « ; ».
173 .PP
174 L'ordre de chargement pour une DLL 16 bits est toujours défini par l'ordre de
175 chargement de la DLL 32 bits qui la contient (qui peut être identifié en
176 observant le lien symbolique du fichier .dll.so 16 bits). Par exemple, si
177 \fIole32.dll\fR est configurée comme builtin, \fIstorage.dll\fR sera également chargée comme
178 builtin puisque la DLL 32 bits \fIole32.dll\fR contient la DLL 16 bits \fIstorage.dll\fR.
179 .PP
180 Exemples :
181 .TP
182 WINEDLLOVERRIDES="comdlg32,shell32=n,b"
183 .br
184 Charge comdlg32 et shell32 comme des DLL windows natives, ou la version
185 intégrée en cas d'échec.
186 .TP
187 WINEDLLOVERRIDES="comdlg32,shell32=n;c:\(rs\(rsfoo\(rs\(rsbar\(rs\(rsbaz=b"
188 .br
189 Charge les bibliothèques windows natives comdlg32 et shell32. De plus, si une
190 application demande le chargement de \fIc:\(rsfoo\(rsbar\(rsbaz.dll\fR, charge la
191 bibliothèque intégrée \fIbaz\fR.
192 .TP
193 WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n;oleaut32="
194 .br
195 Charge la bibliothèque intégrée comdlg32, ou la version native en cas
196 d'échec ; charge la version intégrée de shell32 et la version native de
197 comctl32 ; oleaut32 sera désactivée.
198 .RE
199 .TP
200 .B WINEARCH
201 Spécifie l'architecture Windows à prendre en charge. Peut être
202 .B win32
203 (prise en charge des applications 32 bits uniquement), ou
204 .B win64
205 (prise en charge des applications 64 bits, et 32 bits en mode WoW64).
206 .br
207 L'architecture prise en charge par un préfixe Wine donné est déterminée
208 au moment de sa création et ne peut être modifiée ultérieurement.
209 Si vous exécutez Wine avec un préfixe préexistant, il refusera de démarrer
210 si
211 .B WINEARCH
212 ne correspond pas à l'architecture du préfixe.
213 .TP
214 .B DISPLAY
215 Spécifie l'affichage X11 à utiliser.
216 .TP
217 Variables de configuration du pilote audio OSS :
218 .TP
219 .B AUDIODEV
220 Définit le périphérique pour les entrées/sorties audio, par défaut
221 .IR /dev/dsp .
222 .TP
223 .B MIXERDEV
224 Définit le périphérique pour les contrôles du mixeur, par défaut
225 .IR /dev/mixer .
226 .TP
227 .B MIDIDEV
228 Définit le périphérique pour le séquenceur MIDI, par défaut
229 .IR /dev/sequencer .
230 .SH FICHIERS
231 .TP
232 .I wine
233 Le chargeur de programme de Wine.
234 .TP
235 .I wineconsole
236 Le chargeur de programme de Wine pour les applications en mode console (CUI).
237 .TP
238 .I wineserver
239 Le serveur Wine.
240 .TP
241 .I winedbg
242 Le débogueur de Wine.
243 .TP
244 .I $WINEPREFIX/dosdevices
245 Répertoire contenant le mapping des périphériques DOS. Chaque fichier dans ce
246 répertoire est un lien symbolique vers le fichier périphérique Unix qui implémente
247 un périphérique donné. Par exemple, si COM1 est mappé sur \fI/dev/ttyS0\fR, vous aurez un
248 lien symbolique de la forme \fI$WINEPREFIX/dosdevices/com1\fR -> \fI/dev/ttyS0\fR.
249 .br
250 Les lecteurs DOS sont aussi définis à l'aide de liens symboliques ; par exemple, si le
251 lecteur D: correspond au CDROM monté sur \fI/mnt/cdrom\fR, vous aurez un lien symbolique
252 \fI$WINEPREFIX/dosdevices/d:\fR -> \fI/mnt/cdrom\fR. Le périphérique Unix correspondant à un lecteur
253 DOS peut être spécifié de la même façon, à l'exception du fait qu'il faut utiliser « :: » à
254 la place de « : ». Dans l'exemple précédent, si le lecteur CDROM est monté depuis /dev/hdc,
255 le lien symbolique correspondant sera \fI$WINEPREFIX/dosdevices/d::\fR -> \fI/dev/hdc\fR.
256 .SH AUTEURS
257 Wine est disponible grâce au travail de nombreux développeurs. Pour une liste
258 des auteurs, référez-vous au fichier
259 .I AUTHORS
260 à la racine de la distribution des sources.
261 .SH COPYRIGHT
262 Wine peut être distribué selon les termes de la licence LGPL. Une copie de cette
263 licence se trouve dans le fichier
264 .I COPYING.LIB
265 à la racine de la distribution des sources.
266 .SH BUGS
267 .PP
268 Un rapport sur la compatibilité de nombreuses applications est disponible sur la
269 .UR https://appdb.winehq.org
270 .B base de données d'applications de Wine
271 .UE .
272 N'hésitez pas à y ajouter des entrées pour les applications que vous
273 exécutez actuellement, si nécessaire.
274 .PP
275 Les bugs peuvent être signalés (en anglais) sur le
276 .UR https://bugs.winehq.org
277 .B système de suivi des problèmes de Wine
278 .UE .
279 .SH DISPONIBILITÉ
280 La version publique la plus récente de Wine est disponible sur WineHQ, le
281 .UR https://www.winehq.org/
282 .B quartier général du développement de Wine
283 .UE .
284 .SH "VOIR AUSSI"
285 .BR wineserver (1),
286 .BR winedbg (1),
287 .br
288 .UR https://www.winehq.org/help
289 .B Documentation et support de Wine
290 .UE .