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