wineserver.man.in 3.57 KB
Newer Older
1
.\" -*- nroff -*-
2
.TH WINESERVER 1 "October 2005" "@PACKAGE_STRING@" "Windows on Unix"
3 4 5 6 7 8 9 10 11 12
.SH NAME
wineserver \- the Wine server
.SH SYNOPSIS
.BI wineserver\  [options]
.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\fI[n]\fR, \fB--debug\fI[=n]
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
stderr. \fBwine\fR(1) will automatically set the debug level when
27 28 29
starting \fBwineserver\fR if the +server option is set in the
WINEDEBUG variable.
.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\fI[n]\fR, \fB--kill\fI[=n]
38
Kill the currently running
39
.BR wineserver ,
40 41 42 43 44
optionally by sending signal \fIn\fR. If no signal is specified, sends
a SIGINT first and then a SIGKILL.  The instance of \fBwineserver\fR
that is killed is selected based on the WINEPREFIX environment
variable.
.TP
45
\fB\-p\fI[n]\fR, \fB--persistent\fI[=n]
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 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80
Wait until the currently running
.B wineserver
terminates.
.SH ENVIRONMENT VARIABLES
.TP
.I WINEPREFIX
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
.I WINEPREFIX
to different values for different Wine processes, it is possible to
run a number of truly independent Wine sessions.
.TP
.I WINESERVER
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 91 92 93 94 95 96 97 98 99 100 101 102
.TP
.BI /tmp/.wine- uid
The directory containing the server Unix socket and the lock
file. These files are created in a subdirectory generated from the
WINEPREFIX directory device and inode numbers.
.SH AUTHORS
The original author of
.B wineserver
is Alexandre Julliard. Many other people have contributed new features
and bug fixes. Please check the file Changelog in the Wine
distribution for the complete details.
.SH BUGS
If you find a bug, please submit a bug report at
.UR http://bugs.winehq.org
103
.BR http://bugs.winehq.org .
104 105 106 107 108 109
.UE
.SH AVAILABILITY
.B wineserver
is part of the Wine distribution, which is available through WineHQ,
the Wine development headquarters, at
.UR http://www.winehq.org/
110
.BR http://www.winehq.org/ .
111 112 113
.UE
.SH "SEE ALSO"
.BR wine (1).