[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    kdmconfig(1M) manual page Table of Contents

Name

kdmconfig - configure or unconfigure keyboard, display, and mouse options for OpenWindows and internationalization

Synopsis

kdmconfig -c | -u [ -s host ] [ -v ] [ -f ]

Availability

x86

PowerPC Edition

SUNWos86r

Description

The kdmconfig program configures or unconfigures the appropriate files with the keyboard, display, and mouse information relevant to a client’s machine. These files are /etc/defaultkb and /etc/openwin/server/etc/OWconfig on Solaris x86, and /etc/openwin/server/etc/OWconfig on Solaris (PowerPC Edition). kdmconfig can also be used to set up the display, pointer, and keyboard entries in the bootparams database on a server machine.

The kdmconfig program is normally run during installation, 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 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 OpenWindows configuration. You can then rerun kdmconfig with the -cf options to create a new OpenWindows configuration.

Options

The valid options are:
-c
Run the program in the configuration mode. This mode is used to create or update the defaultkb and OWconfig files on Solaris x86, and the OWconfig file on Solaris (PowerPC Edition). When invoked in this way, kdmconfig first looks for the relevant configuration information in the bootparams databases. The bootparams 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.
-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 /etc/openwin/server/etc/OWconfig and /etc/defaultkb files in Solaris x86, and the /etc/openwin/server/etc/OWconfig file in Solaris (PowerPC Edition).
-s client
Set up the bootparams 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. Either the -c or the -u option must be used in conjunction with the -s option. 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 file to look for a bootparams database on a local server. This option is only available to the superuser.
-v
Enable verbose mode. Normally, kdmconfig will not produce any output. This option is helpful for debugging, as it records the different actions taken by kdmconfig on stderr.
-f
Force screens mode. When invoked with -f, 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, bypassing network probing when setting up a server.

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

/etc/defaultkb
pointer to default keyboard layout

PowerPC Edition Only

/platform/prep/kernel/drv/kd.conf
keyboard configuration file

See Also

admintool(1M) , bootparamd(1M) , sys-unconfig(1M) , sysidconfig(1M) , bootparams(4)

PowerPC Edition Only

loadkeys(1)

Notes

The -s option is an uncommitted option, and may be replaced by functionality in the admintool(1M) hostmanager functions in a later release of Solaris.


Table of Contents