System Administration Commands 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 applies only to the Xsun window system
environment, 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 confi-
guration steps.
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. kdmconfig
can also be used to set up the display, pointer, and key-
board 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 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, kdmconfig first looks for the relevant con-
figuration information in the bootparams(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 sub-
net as the client, provided the server machine is run-
ning 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
SunOS 5.11 Last change: 14 Nov 2006 1
System Administration Commands kdmconfig(1M)
screens as the -c option, but the information you
specify is saved as sysidcfg(4) keywords (monitor, key-
board, 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 net-
work probing will be performed. This is helpful when
debugging the client's configuration environment. Note
that the -s option implies the use of -f, bypassing net-
work 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 avail-
able 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 ses-
sion (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,
SunOS 5.11 Last change: 14 Nov 2006 2
System Administration Commands kdmconfig(1M)
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
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 14 Nov 2006 3
System Administration Commands kdmconfig(1M)
ATRIBUTE TYPE ATRIBUTE VALUE
Architecture x86
Availability SUNWos86r
SEE ALSO
bootparamd(1M), sys-unconfig(1M), sysidconfig(1M), boot-
params(4), nsswitch.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.11 Last change: 14 Nov 2006 4
|
