| .TH WINESERVER 1 "October 2005" "@PACKAGE_STRING@" "Windows on Unix" |
| .SH NAME |
| wineserver \- the Wine server |
| .SH SYNOPSIS |
| .B wineserver |
| .RI [ 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 |
| is normally launched automatically when starting \fBwine\fR(1), so you |
| 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 |
| \fB\-d\fR[\fIn\fR], \fB--debug\fR[\fB=\fIn\fR] |
| Set the debug level to |
| .IR n . |
| 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 |
| stderr. \fBwine\fR(1) will automatically enable normal level debugging |
| when starting \fBwineserver\fR if the +server option is set in the |
| \fBWINEDEBUG\fR variable. |
| .TP |
| .BR \-f ", " --foreground |
| Make the server remain in the foreground for easier debugging, for |
| instance when running it under a debugger. |
| .TP |
| .BR \-h ", " --help |
| Display a help message. |
| .TP |
| \fB\-k\fR[\fIn\fR], \fB--kill\fR[\fB=\fIn\fR] |
| Kill the currently running |
| .BR wineserver , |
| optionally by sending signal \fIn\fR. If no signal is specified, sends |
| 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 |
| variable. |
| .TP |
| \fB\-p\fR[\fIn\fR], \fB--persistent\fR[\fB=\fIn\fR] |
| 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 |
| .BR \-v ", " --version |
| Display version information and exit. |
| .TP |
| .BR \-w ", " --wait |
| Wait until the currently running |
| .B wineserver |
| terminates. |
| .SH ENVIRONMENT |
| .TP |
| .B 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 |
| .B WINEPREFIX |
| to different values for different Wine processes, it is possible to |
| run a number of truly independent Wine sessions. |
| .TP |
| .B 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 |
| .IR @bindir@/wineserver , |
| 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 |
| .BR wine . |
| .TP |
| .BI /tmp/.wine- uid |
| Directory containing the server Unix socket and the lock |
| file. These files are created in a subdirectory generated from the |
| \fBWINEPREFIX\fR 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. For a complete list, see the git commit logs. |
| .SH BUGS |
| Bugs can be reported on the |
| .UR http://bugs.winehq.org |
| .B Wine bug tracker |
| .UE . |
| .SH AVAILABILITY |
| .B wineserver |
| is part of the Wine distribution, which is available through WineHQ, |
| the |
| .UR http://www.winehq.org/ |
| .B Wine development headquarters |
| .UE . |
| .SH "SEE ALSO" |
| .BR wine (1), |
| .br |
| .UR http://www.winehq.org/help |
| .B Wine documentation and support |
| .UE . |