kdmconfig(1M)						  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 configuration steps.

       The kdmconfig program configures or unconfigures the /etc/openwin/server/etc/OWconfig file with the keyboard, display, and  mouse  informa-
       tion  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  sysid-
       cfg(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  configuration  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 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	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 produce 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 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 ALSO

       bootparamd(1M), sys-unconfig(1M), sysidconfig(1M), bootparams(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							    14 Nov 2006 						     kdmconfig(1M)