kdmconfig(1M) System Administration Commands kdmconfig(1M)NAMEkdmconfig - configure or unconfigure keyboard, display, and mouse
options for OpenWindows and internationalization
SYNOPSISkdmconfig
kdmconfig [-fv] [-s hostname] -c | -t | -u | -d filename
DESCRIPTION
The kdmconfig program applies only to the Xsun window system environ‐
ment, which is no longer the default in Solaris x86. If you want to use
Xsun, you must run kdmconfig from the command line, select Xsun, and
perform the remaining configuration steps.
The kdmconfig program configures or unconfigures the /etc/open‐
win/server/etc/OWconfig file with the keyboard, display, and mouse
information relevant to a client's machine on x86 based systems for
Solaris software. kdmconfig 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 keywords in a
sysidcfg(4) file. kdmconfig can only be run as root or with privileges
comparable to root. Upon completion of device selection, kdmconfig
prompts the user to test the configuration, which is done by running
the window system.
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, kdm‐
config first looks for the relevant configuration information in
the bootparams(4) databases. It also takes into account the infor‐
mation 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 sysid‐
cfg(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 installation.
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 keywords 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 con‐
figuration environment. Note that the -s option implies the use of
-f, bypassing 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 nss‐
witch.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 produce any out‐
put. This option is helpful for debugging, as it records the dif‐
ferent actions taken by kdmconfig on stderr.
No Options
Run without options, kdmconfig is used to edit the current configura‐
tion. 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 kdm‐
config.
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 attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Architecture │x86 │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWos86r │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSObootparamd(1M), sys-unconfig(1M), sysidconfig(1M), bootparams(4), nss‐
witch.conf(4), sysidcfg(4), attributes(5)
See also the Xorg(1) and xorg.conf(4) man pages, which are found under
/usr/X11/man on some Solaris systems. These man pages are not part of
the SunOS man page collection.
SunOS 5.10 14 Nov 2006 kdmconfig(1M)