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