wineserver.man.in 3.59 KB
Newer Older
1
.TH WINESERVER 1 "October 2005" "@PACKAGE_STRING@" "Windows on Unix"
2 3 4
.SH NAME
wineserver \- the Wine server
.SH SYNOPSIS
5 6
.B wineserver
.RI [ options ]
7 8 9 10 11 12
.SH DESCRIPTION
.B wineserver
is a daemon process that provides to Wine roughly the same services
that the Windows kernel provides on Windows.
.PP
.B wineserver
13
is normally launched automatically when starting \fBwine\fR(1), so you
14 15 16 17 18
shouldn't have to worry about it. In some cases however, it can be
useful to start \fBwineserver\fR explicitly with different options, as
explained below.
.SH OPTIONS
.TP
19
\fB\-d\fR[\fIn\fR], \fB--debug\fR[\fB=\fIn\fR]
20
Set the debug level to
21
.IR n .
22 23 24 25
0 means no debugging information, 1 is the normal level, and 2 is for
extra verbose debugging. If
.I n
is not specified, the default is 1. The debug output will be sent to
26 27
stderr. \fBwine\fR(1) will automatically enable normal level debugging
when starting \fBwineserver\fR if the +server option is set in the
28
\fBWINEDEBUG\fR variable.
29
.TP
30
.BR \-f ", " --foreground
31 32 33
Make the server remain in the foreground for easier debugging, for
instance when running it under a debugger.
.TP
34
.BR \-h ", " --help
35 36
Display a help message.
.TP
37
\fB\-k\fR[\fIn\fR], \fB--kill\fR[\fB=\fIn\fR]
38
Kill the currently running
39
.BR wineserver ,
40
optionally by sending signal \fIn\fR. If no signal is specified, sends
41 42
a \fBSIGINT\fR first and then a \fBSIGKILL\fR.  The instance of \fBwineserver\fR
that is killed is selected based on the \fBWINEPREFIX\fR environment
43 44
variable.
.TP
45
\fB\-p\fR[\fIn\fR], \fB--persistent\fR[\fB=\fIn\fR]
46 47 48 49 50 51 52
Specify the \fBwineserver\fR persistence delay, i.e. the amount of
time that the server will keep running when all client processes have
terminated. This avoids the cost of shutting down and starting again
when programs are launched in quick succession. The timeout \fIn\fR is
in seconds, the default value is 3 seconds. If \fIn\fR is not
specified, the server stays around forever.
.TP
53
.BR \-v ", " --version
54 55
Display version information and exit.
.TP
56
.BR \-w ", " --wait
57 58 59
Wait until the currently running
.B wineserver
terminates.
60
.SH ENVIRONMENT
61
.TP
62
.B WINEPREFIX
63 64 65 66 67 68 69 70 71
If set, the content of this variable is taken as the name of the directory where
.B wineserver
stores its data (the default is \fI$HOME/.wine\fR). All
.B wine
processes using the same
.B wineserver
(i.e.: same user) share certain things like registry, shared memory
and kernel objects.
By setting
72
.B WINEPREFIX
73 74 75
to different values for different Wine processes, it is possible to
run a number of truly independent Wine sessions.
.TP
76
.B WINESERVER
77 78 79 80
Specifies the path and name of the
.B wineserver
binary that will be launched automatically by \fBwine\fR. If not set,
\fBwine\fR will try to load
81
.IR @bindir@/wineserver ,
82 83 84 85 86 87
and if this doesn't exist it will then look for a file named
\fIwineserver\fR in the path and in a few other likely locations.
.SH FILES
.TP
.B ~/.wine
Directory containing user specific data managed by
88
.BR wine .
89 90
.TP
.BI /tmp/.wine- uid
91
Directory containing the server Unix socket and the lock
92
file. These files are created in a subdirectory generated from the
93
\fBWINEPREFIX\fR directory device and inode numbers.
94 95 96 97
.SH AUTHORS
The original author of
.B wineserver
is Alexandre Julliard. Many other people have contributed new features
98
and bug fixes. For a complete list, see the git commit logs.
99
.SH BUGS
100
Bugs can be reported on the
101
.UR http://bugs.winehq.org
102 103
.B Wine bug tracker
.UE .
104 105 106
.SH AVAILABILITY
.B wineserver
is part of the Wine distribution, which is available through WineHQ,
107
the
108
.UR http://www.winehq.org/
109 110
.B Wine development headquarters
.UE .
111
.SH "SEE ALSO"
112 113 114 115 116
.BR wine (1),
.br
.UR http://www.winehq.org/help
.B Wine documentation and support
.UE .