server/wineserver.man.in

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