This chapter describes the SoftWindows system configuration and user configuration files, and the X-resource configuration options. It covers the following topics:
Each user's configuration settings are stored in a file named .swinconfig in the user's home directory. This file determines the settings that appear in the Options menu dialog boxes. If the user changes any of the settings, and the Save Configuration Changes option is checked in the Exit dialog box, the new values will be saved in the user's configuration file on exiting SoftWindows.
You can also edit the SoftWindows configuration file using a UNIX text editor, such as vi.
When a user launches SoftWindows, the initial configuration settings are determined by the system configuration file, sys.swinconfig, which is installed in the SoftWindows installation directory.
The system administrator can edit the system configuration file to provide users with different initial settings.
After it is edited sys.swinconfig must be owned by root, and the SUID bit must be set. If necessary, login as root and from the $SWINHOME directory enter the commands:
chown root sys.swinconfig chmod 4444 sys.swinconfig |
The system configuration file also contains entries to determine the default values for the LPT and COM port settings, the maximum size of the hard disk drive and memory, and the initial size of the Windows desktop.
A full listing of the SoftWindows system configuration file is given on the following pages. The following entries determine the user's initial SoftWindows preferences:
DRIVE_C_FILE_NAME $HOME/WIN95-username.hdf DRIVE_D_FILE_NAME DRIVE_CDROM_DEVICE_NAME DRIVE_D_FSA_DIRECTORY DRIVE_E_FSA_DIRECTORY $HOME DRIVE_F_FSA_DIRECTORY DRIVE_G_FSA_DIRECTORY DRIVE_H_FSA_DIRECTORY $HOME DRIVE_Z_FSA_DIRECTORY DRIVE_FLOPPY_A_DEVICE_NAME DRIVE_FLOPPY_B_DEVICE_NAME DISPLAY_GRAPHICS_ADAPTOR SVGA DISPLAY_SIZE 1.0 DISPLAY_MSWIN_WIDTH 640 DISPLAY_MSWIN_HEIGHT 480 DISPLAY_MSWIN_COLOURS 16 MEMORY_EXTENDED_SIZE 16 LPT_PORT_1_TYPE LPT_PORT_2_TYPE LPT_PORT_3_TYPE LPT_PORT_1 LPT_PORT_2 LPT_PORT_3 LPT_PORT_1_PS_FLUSH No LPT_PORT_2_PS_FLUSH No LPT_PORT_3_PS_FLUSH No COM_PORT_1_TYPE COM_PORT_2_TYPE COM_PORT_3_TYPE COM_PORT_4_TYPE COM_PORT_1 COM_PORT_2 COM_PORT_3 COM_PORT_4 COM_PORT_1_PS_FLUSH No COM_PORT_2_PS_FLUSH No COM_PORT_3_PS_FLUSH No COM_PORT_4_PS_FLUSH No COM_PORT_1_FLOW No COM_PORT_2_FLOW No COM_PORT_3_FLOW No COM_PORT_4_FLOW No SECURE No SECURE_MASK 0 SOUND No AUTO_FREEZE No AUTO_FLUSH Yes FPU_EMULATION Yes AUTO_FLUSH_DELAY 50 KEYBOARD_MAP_FILE_NAME $SWINHOME/keyboard/kbd † FILE_DEFAULT $HOME/SoftWin.tmp DEVICE_DEFAULT device † PIPE_DEFAULT lp DRIVE_HARD_DISK_MAX_SIZE 500 MEMORY_EXTENDED_MAX_SIZE 32 MSWIN_RESIZE Next CMOS bytes * DRIVE_D_FSA_OPTION Lower . . DRIVE_Z_FSA_OPTION Lower DISK_DEFAULT_SIZE 180 WINDOW_RESIZE_MODE Smart TURBO_START_FILE_NAME $HOME/.swinturbo DEFAULT_ETHERNET_DEVICE DEFAULT_TOKENRING_DEVICE MUTE_WINDOWS_SOUND No IGNORE_WINDOWS_VOLUME No |
† These items depend on the SoftWindows platform and the configuration of the workstation. The typical value of kbd is SGINDYus.kbd.
* The CMOS line lists 64 hexadecimal numbers, separated by spaces.
The following sections provide details of the alternative values for particular configuration entries:
Table 7-1. MSWIN_RESIZE Values
Table 7-2. LPT_PORT_x_TYPE Values
Value | Description |
|---|---|
File | Output to a UNIX file. |
Pipe | Pipe to a UNIX process (for example, a print spooler). |
Device | Output to a UNIX serial port. |
Blank | Port disabled. |
Table 7-3. COM_PORT_x_TYPE Values
Value | Description |
|---|---|
File | Output to a UNIX file. |
Pipe | Pipe to a UNIX process (for example, a print spooler). |
Device | Output to a UNIX serial port. |
Blank | Port disabled. |
Table 7-5. DRIVE_x_FSA_OPTION Values
Value | Description |
|---|---|
Lower | Files are saved to FSA drives in lower case |
Upper | Files are saved to FSA drivers in upper case. |
Insensitive | Case is irrelevant. |
Table 7-6. WINDOW_RESIZE_MODE Values
Value | Description |
|---|---|
Smart | the Windows 95 desktop is automatically resized when the SoftWindows window is resized. |
None | The SoftWindows window cannot be resized. |
Restart | Resizing the SoftWindows prompt the user to restart SoftWindows, for use with Windows 3.11. |
This entry is optional. If a user does not have write permission to a SoftWindows hard disk file, a warning dialog box will normally be displayed when SoftWindows starts up. The option RO_DISK_PANEL_DISABLE allows you to override this default action as follows:
Table 7-7. RO_DISK_PANEL_DISABLE Values
Value | Description |
|---|---|
No or omitted | The warning dialog box will be displayed if the user cannot write to the disk. |
Yes | The warning dialog box is not displayed. |
The _DEFAULT entries can be changed by the system administrator to determine the default values for the options in the Comms Ports and Lpt Ports dialog boxes.
The _MAX_SIZE entries can be changed by the system administrator to determine the maximum disk and memory sizes.
The following entries do not appear in the user's individual configuration file ($HOME/.swinconfig): FILE_DEFAULT, DEVICE_DEFAULT, PIPE_DEFAULT, SECURE, SECURE_MASK, DRIVE_HARD_DISK_MAX_SIZE, and MEMORY_EXTENDED_MAX_SIZE.
SECURE is optional, but if it is not preset, the default value assumed is Yes, so it should be preset to No if secure mode operation is not required.
SECURE_MASK is intended for future expansion and should be set to 0.
Since SoftWindows is an X Windows-based application, you can restrict access to parts of the SoftWindows menu tree by editing the SoftWindows X resource file, sOftWindows, located in $SWINHOME.
When editing the SoftWindows X resource file note that the X resource name sOftWindows must start at the beginning of the line. The value field must be separated from the name by spaces or tabs, and there must be no extra spaces or tabs at the end of the line.
Each menu item can be individually grayed out by setting its sensitive setting to false. For example, to restrict users from accessing the Display… option, locate the following line in the sOftWindows file:
sOftWindows*dispPBG.sensitive:true |
And change it to:
sOftWindows*dispPBG.sensitive:false |
Alternatively, you can gray out entire menu options, by setting the sensitive setting of the parent menu option to false. For example, to restrict users from accessing the entire Options menu, locate the following line in the sOftWindows file:
sOftWindows*optionCBW.sensitive:true |
And change it to:
sOftWindows*optionCBW.sensitive:false |
To restrict users from accessing any of the SoftWindows menus, except for the Help menu, change the following lines in the sOftWindows file:
sOftWindows*fileCBW.sensitive:true sOftWindows*optionCBW.sensitive:true sOftWindows*actionCBW.sensitive:true |
To the following:
sOftWindows*fileCBW.sensitive:false sOftWindows*optionCBW.sensitive:false sOftWindows*actionCBW.sensitive:false |
To change the fonts on the SoftWindows menus, either edit the following line in the sOftWindows file, if present, or add a similar line to the file:
sOftWindows*FontList:screen14 |
When the user launches Microsoft Windows, depending on the current MSWIN_RESIZE configuration setting, the Resize dialog box may appear. This allows the user to select the size of the user's Microsoft Windows desktop. The sizes provided in the Resize dialog box are set in the SoftWindows resource file, sOftWindows, and are defined using the following lines:
sOftWindows*stdScreenSize1: 640 480 sOftWindows*stdScreenSize2: 800 600 sOftWindows*stdScreenSize3: 1024 768 sOftWindows*stdScreenSize4: 1152 864 sOftWindows*stdScreenSize5: 1152 864 |
To change the default size settings, simply modify the relevant lines. For example, to make the fifth default size equal to 1600 x 1200, change the last line to:
sOftWindows*stdScreenSize5: 1600 1200 |