Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

kdmconfig


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
         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,
         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


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:








     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE 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.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments