kdmconfig man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

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  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 ALSO
       bootparamd(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)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net