Trouble Shooting Guide

General stuff

/etc/default/merge

The file /etc/default/merge has a lot of settings that govern Win4Lin. Some of these must NOT be changed. Others can be changed, and all users will get the new settings. Settings in the user's environment can be used to override the default settings from /etc/default/merge.

Watch this space for descriptions of the settings in /etc/default/merge. Until then follow the directions of other documentation for changing certain settings.

Details on Win4Lin Logging

All Win4Lin programs have built in logging capability. You can set these environment variables in /etc/default/merge or export them in your local environment.

Summary Table:
Program Environment Default file Default bit flags Start/stop





win ; dos DOS_LOG @dos.log ffff SIGPWR
xcrt XCRT_LOG @xcrt.log 1000 SIGPWR
em EM_LOG
MRGWIN_LOG*
@.merge/em.log 0 none
winsock WSOCK_LOG @wsock.log 1000 SIGPWR
winsetup WINSETUP_LOG @winsetup.log 1000 none
crt CRT_LOG @crt.log 1000 none
tkbd TKBD_LOG @tkbd.log 1000 none
upgrade_u UPGRADE_U_LOG @upgrade_u.log ffff none
admconvert ADMCONVERT_LOG @admconvert.log 1000 none
winadmin WINADMIN_LOG @winadmin.log 1000 none
winconfig WINCONFIG_LOG @winconfig.log 1000 none
makexsym MAKEXSYM_LOG @makexsym.log 1000 none
mapfname MAPFNAME_LOG @mapfname.log ffffffff none
old_x_res OLD_X_RES_LOG @old_x_res.log ff none
*MRGWIN_LOG is a second optional logging value that only specifies a bit flags value.
Note: Not all versions of Win4Lin/SCO Merge have all of the above programs.
Note: SIGPWR is 30 on Linux, and 19 on SCO OpenServer and UnixWare.

Note: The filename specification:

Note: Environment variable setting: The Logging variable must be set to one of the following forms:

        xxxxxxxx:filename 
        filename:xxxxxxxx 
        xxxxxxxx 
        filename 
Where filename is the filename specification as explained above, and xxxxxxxx is up to a eight hex digit value (for 32 bit flags). Each bit flag enables a certain kind of logging. The different programs use the big flags in different ways, and not all the 32 bit flags are necessarily always used. Also the significance of the bit flags may change from release to release. So typically you only use the default except when advised to try another value.

For those programs that have a logging start/stop signal, the setting can be preceded by a plus character, "+", which delays the start of logging to when start signal is done. Examples using the '+' variation:

        +/tmp/mylog:1ffff
        +@homelog
        +ffffffff
        +
The default DOS_LOG and XCRT_LOG setting in /etc/default/merge are both "+". This means that when the SIGPWR signal is send to the dos, win or xcrt processes then they will start logging using the default filename and bit flag value.

When sending the signal to the dos or win process, you must be careful to send it to the correct process. Each session has two dos or two win processes. One process is the "parent" of the other. This signal is to be sent to the parent process, NOT the child process.