kdmconfig(1M)
NAME
kdmconfig - configure or unconfigure keyboard, display, and
mouse options for OpenWindows and internationalization
SYNOPSIS
kdmconfig
kdmconfig [-fv] [-s hostname] -c | -t | -u | -d filename
DESCRIPTION
The kdmconfig program configures or unconfigures the
/etc/openwin/server/etc/OWconfig file with the keyboard,
display, and mouse information relevant to a client's
machine on x86 based systems for Solaris software. kdmcon-
fig can also be used to set up the display, pointer, and
keyboard entries in the bootparams(4) database on a server
machine or the monitor, keyboard, display, and pointer key-
words in a sysidcfg(4) file. kdmconfig can only be run by
the super-user. Upon completion of device selection,
kdmconfig prompts the user to test the configuration, which
is done by running the window system.
The kdmconfig program is normally run during installation
and upon reboot, but it can also be run from the command
line after the system has been installed. When configuring a
client during an initial installation or a reconfigure
reboot, the sysidconfig(1M) program will invoke kdmconfig
with the -c option, and when the user executes the sys-
unconfig(1M) program, kdmconfig will be executed with the -u
option. Similarly, when you run kdmconfig from the command
line, use the -u option to unconfigure the existing OpenWin-
dows configuration. You can then rerun kdmconfig with the
-cf options to create a new OpenWindows configuration. To
edit the existing configuration, run kdmconfig from the com-
mand line without options. After each reboot, kdmconfig will
be invoked by the system with the -t (test mode) option to
ensure autoconfiguration capability and identify possible
conflicts between the current configuration and the one
recorded in the OWconfig file.
OPTIONS
The valid options are:
-c Run the program in the configuration mode. This mode
is used to create or update the OWconfig file. When
invoked in this way, kdmconfig first looks for the
relevant configuration information in the boot-
params(4) databases. It also takes into account the
information returned from device probes, unless the -s
option is also used. The bootparams(4) databases
available to the client are all of the /etc/bootparams
files on servers on the same subnet as the client,
provided the server machine is running the
bootparamd(1M) daemon. kdmconfig is invoked with the
-c option when called by sysidconfig(1M)
-d filename
Set up a sysidcfg(4) file. This option displays the
same screens as the -c option, but the information you
specify is saved as sysidcfg(4) keywords (monitor,
keyboard, display, and pointer). This enables you to
use a sysidcfg (4) file to preconfigure a system's
device information and bypass kdmconfig during an ins-
tallation.
filename is the sysidcfg(4) file that is created, and
it is created in the directory where kdmconfig is
being run unless a path is specified. If filename
already exists in the specified directory, the key-
words are appended to the existing file.
-f Force screens mode. When this option is invoked, no
network probing will be performed. This is helpful
when debugging the client's configuration environment.
Note that the -s option implies the use of -f, bypass-
ing network probing when setting up a server.
-s hostname
Set up the bootparams(4) database on this machine for
the specified client. This option presents the same
screens as it does when run on a client, but instead
writes the resulting information to the
/etc/bootparams file. Also, -s implies the use of the
-f option. That is, the program will always present
the screens to the user when invoked this way. This
option will reconfigure the nsswitch.conf( 4) file to
look for a bootparams(4) database on a local server.
This option is only available to the super-user.
-t Run the program in test mode. In this mode, kdmconfig
will use device probe information to determine whether
the OWconfig file contains complete and up-to-date
information about the keyboard, display, and mouse. If
the information is accurate, kdmconfig will exit
silently. Otherwise, kdmconfig will prompt for the
super-user password and proceed to a normal editing
session (as though it had been run without options).
-u Unconfigure the system, returning it to an "out-of-
the-box" state. In this state, the factory default
keyboard, mouse, and display are selected as a result
of removing the device configuration entries from the
/etc/openwin/server/etc/OWconfig file. This may result
in an unusable configuration for the display server.
-v Enable verbose mode. Normally, kdmconfig will not pro-
duce any output. This option is helpful for debugging,
as it records the different actions taken by kdmconfig
on stderr.
No Options
Run without options, kdmconfig is used to edit the current
configuration. kdmconfig uses the information from the
OWconfig file in addition to information obtained from the
bootparams(4) file and from device probes. In other
respects, it is similar to using the -c option of kdmconfig.
FILES
/etc/openwin/server/etc/OWconfig
OpenWindows configuration file
/etc/bootparams
contains list of clients that diskless clients use for
booting
/etc/nsswitch.conf
name service configuration file
x86 Only
/dev/openprom
installed devices and properties
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Architecture | x86 |
|_____________________________|_____________________________|
| Availability | SUNWos86r |
|_____________________________|_____________________________|
SEE ALSO
bootparamd(1M), sys-unconfig(1M), sysidconfig(1M), boot-
params(4), nsswitch.conf(4), sysidcfg(4), attributes(5)
Man(1) output converted with
man2html