winconfig, addwinconfig, delwinconfig, listwinconfig -- manage Win4Lin session configurations under Win4Lin.

Syntax

winconfig config list [ option[,option] ... ]

winconfig config set option=value

winconfig config delete customdev=value

addwinconfig existing_config [copyto] new_config

delwinconfig config

listwinconfig

Description

winconfig - display, set, or delete Merge configuration options

addwinconfig - create a new Merge configuration

delwinconfig - delete a Merge configuration

listwinconfig - list Merge configurations

The winconfig and related commands allow you to configure the characteristics of Win4Lin sessions and save those configurations for future use.

Each user starts with one standard DOS configuration and one standard Windows configuration, dos and win, respectively. You can modify the standard configurations, create and modify new named configurations, list configurations, and delete configurations.

Most of these commands are alternatives to the Merge Setup utility, which is accessible on the X Desktop. You can use Merge Setup instead of winconfig to specify and save configuration options. The Merge Setup Save As button has the same effect as addwinconfig. Merge Setup also lists the names of saved configurations and allows you to delete them.

The winconfig command displays, sets, or deletes configuration options that customize Win4Lin sessions.

config is either the standard dos or win configuration names or the name of a saved, customized Win4Lin configuration.

Use the winconfig list command to display option values, the winconfig set command to set option values, and the winconfig delete command to remove option definitions. delete can be used only to remove customdev settings from a configuration.

option can be any of the options listed below, which affect the operation of Win4Lin sessions.

Use addwinconfig to create and save new Merge configurations. A new configuration starts as a copy of an existing configuration. Select an existing DOS or Windows Win4Lin configuration depending on whether your new configuration is for a DOS or Windows environment. Once you create a new configuration, you can use winconfig to customize it any way you want.

Configuration names can contain up to 10 characters including A through Z (uppercase or lowercase), 0 through 9, and the hyphen (-).

You can start Win4Lin sessions using saved configurations by using Merge Setup (on the X Desktop) or by using the Linux command-line +k option as follows:

dos +k[user:]config

or

win +k[user:]config

The user option allows you to share configurations with other users. When you specify user, you use the named configuration that belongs to the specified user.

Note: You cannot use the +kuser:config option to specify a configuration belonging to an NIS-administered user other than yourself.

The dos and win commands with no arguments are equivalent to dos +kdos and win +kwin, respectively.

The delwinconfig command deletes a saved configuration. You cannot delete the standard dos or win configurations.

The listwinconfig command displays the names of all configurations.

The winconfig options and their legal values are listed below. Some values are tokens. (A token is a brief name for a hardware device that is either predefined by Merge or added by the system administrator. See winadmin(1) for additional information on tokens.)

autoexecglobal=
Specifies whether the file J:\autoexec.bat is used when you start a Win4Lin session. Values are true or false.

autoexeclocal=
Specifies whether the /autoexec.bat file on your personal drive is used when you start a Win4Lin session. Values are true or false.

autoexecprivate=
Specifies an autoexec.bat file used when you start a Win4Lin session. The value is the full Linux path name to the file or blank.

autofreeze=
Specifies whether your session is temporarily suspended while the input focus is switched away from your session's window to another window. Values are true or false.

autozoom=
Specifies whether or not the Win4Lin session zooms automatically. Values are true or false.

com1=
Specifies the serial port to attach for COM1 during a Win4Lin session. The value is a com1 class token.

com2=
Specifies the serial port to attach for COM2 during a Win4Lin session. The value is a com2 class token.

configglobal=
Specifies whether the file J:\config.sys is used when you start a Win4Lin session. Values are true or false.

configlocal=
Specifies whether the /config.sys file on your personal drive is used when you start a Win4Lin session. Values are true or false.

configprivate=
Specifies a config.sys file to use when you start a Win4Lin session. The value is the full Linux path name to the file or blank.

customdev=
Specifies a device to attach during a Win4Lin session. The value is a custom class token.

displaytype=
Specifies the display type to be used for a DOS session. The values are auto, vga, cga, mono, herc.

dosfont=
Specifies the font size to be used for a DOS session running inside an X window. The values are auto, small, and medium.

drive=
Specifies how drive letters are mapped. This option has the following form:
   drive=driveletter,drive_name[,readonly][,exclusive]
Here, driveletter is the DOS drive letter; drive_name can be none, indicating that the drive is not mapped to anything, a DOS fixed disk in the form dosn, or a token for a virtual drive.

ems=
Specifies the amount of expanded memory to be attached to a Win4Lin session. The value is a number of megabytes of expanded memory from 0 through 8.

installcolormap=
Specifies whether a private color map is used for Win4Lin sessions running on the Desktop. Values are true and false.

lptn=
Specifies the DOS printer ports for Win4Lin sessions (LPT1, LPT2, or LPT3). The value is a printer class token, followed by a timeout value t from 5 through 3600 (or 0, which means printing never occurs as the result of a timeout), as follows:
   lpt1=token,t

maxcolors=
Value is low, medium, or high. Specifies the maximum number of colors Win4Lin allocates to a Windows session. low allocates only 20 colors. medium reserves an additional 49 colors. high reserves the original 20 colors, plus 109 more. (This option is useful only when using a shared colormap, i.e. installcolormap is set to false, and the Desktop display has 256 colors.)

memory=
Specifies the amount of standard memory to be attached to a Windows session. The value is a number of megabytes of standard memory from 1 through 64.

mouse=
Specifies the mouse definition for the Win4Lin session. The value is a mouse class token.

personaldrive=
Specifies the DOS drive letter to be used as your personal drive.

run=
Specifies an optional command that Win4Lin is to run when a session starts.

scaledosgraphics=
Specifies the graphics scaling factor to be used for DOS sessions running on the Desktop in Hercules or CGA modes. Values are auto, 1, and 2.

session=
Specifies the type of Win4Lin session this configuration is used for. Values are dos, win3x, or win95. (>win95 is also used for Windows 98.)

showmenukey=
Specifies the key combination that brings the menu and status bars your Win4Lin window back into view or unfocuses the mouse when it is focused to the DOS Win4Lin window. You can set the key combination to any combination of <Ctrl>, <Alt>, and <Shift> keys plus another key, which you specify with the X key symbol name. When you specify more than one key, separate them with spaces and surround the combination with quotes. For example, to set the key combination to <Ctrl><Alt><Shift><F10>:

showmenukey="ctrl alt shift F10"

To set the showmenu key to be just the <Home> key:

showmenukey=Home

By default, Win4Lin defines <Shift><F12> as the key sequence.

startzoomed=
Specifies whether to zoom your session to full screen as soon as it is started from the Desktop. The value is true or false.

unzoomkey=
Specifies the key combination that unzooms. You can set the key combination to any combination of <Ctrl>, <Alt>, and <Shift> keys plus another key, which is specified using the X key symbol name. When you specify more than one key, separate them with spaces and surround the combination with quotes. For example, to set the key combination to <Ctrl><Alt><Shift><F10>:

unzoomkey="ctrl alt shift F10"

To set the unzoom key to be just the <Home> key:

unzoomkey=Home

By default, Win4Lin defines <Shift><F12> as the key sequence.

windowsdir=
Specifies the subdirectory on your personal drive where Windows is installed. A typical setting is "windows".

windowsizeauto=
Specifies that Win4Lin should automatically compute the window size when a Windows 3.1 session starts. (Obsolete) Values are true and false. When set to true, the windowswidth= and windowsheight= commands are ignored.

windowswidth=
Specifies the width of the Windows 3.1 window in pixels. (Obsolete) The minimum width is 600. This option is ignored when the value for windowsizeauto= is true.

windowsheight=
Specifies the height of the Windows 3.1 window in pixels. (Obsolete) The minimum height is 400. This option is ignored when the value for windowsizeauto= is true.

windowsmode=
Specifies whether your Windows 3.1 environments start in standard mode or in enhanced mode. (Obsolete) The values are standard and enhanced.

windowspaging=
Specifies whether or not Windows 3.1 environments that run in enhanced mode should use the Virtual Memory features of Windows. (Obsolete) Values are true and false.

xcutandpaste=
Specifies whether or not your Windows environments start with the X Cut and Paste feature turned on or off. Values are true and false.

See also

win(1)
winadmin(1)
Win4Lin User's Guide

© 2000 TreLOS, Inc.

2000/01/10