share/man/man4/man4.i386/console.4

   1 .\"     $NetBSD: console.4,v 1.10 2006/09/06 16:47:00 rpaulo Exp $
   2 .\"
   3 .Dd September 6, 2006
   4 .Dt CONS 4 i386
   5 .Os
   6 .Sh NAME
   7 .Nm console
   8 .Nd i386 console interface
   9 .Sh SYNOPSIS
  10 .Cd options CONSDEVNAME=string
  11 .Cd options CONADDR=integer
  12 .Cd options CONSPEED=integer
  13 .Cd options CONS_OVERRIDE
  14 .Cd options CONMODE=integer
  15 .Sh DESCRIPTION
  16 The
  17 .Dq console
  18 device is used for
  19 .Em kernel printf
  20 messages and accesses to the
  21 .Pa /dev/console
  22 character special device in user mode.
  23 It is attached to a hardware interface at boot time controlled by options
  24 in the kernel configuration file, or information passed by the boot loader.
  25 .Pp
  26 Bootblocks from
  27 .Nx 1.4
  28 or newer select their console device from a compiled-in list,
  29 and then pass their choice of console device and console parameters to
  30 the kernel.
  31 .Pp
  32 As of
  33 .Nx 1.5 ,
  34 the
  35 .Ic consdev
  36 bootblock command allows changing the console device on-the-fly.
  37 .Pp
  38 The kernel will use the same console device as the
  39 bootblock; no special kernel configuration is required.
  40 .Pp
  41 To override
  42 the bootblock's choice of console, or to use a serial kernel console
  43 with older bootblocks, you must specify kernel config-file options to
  44 override the information passed by the bootblock.
  45 The current option choices are:
  46 .Bl -tag -width aaa
  47 .It - the standard PC keyboard and display
  48 (with either the
  49 .Dq pc
  50 or the
  51 .Xr wscons 4
  52 driver)
  53 .It - standard PC serial ports
  54 (with
  55 .Xr com 4
  56 driver)
  57 .El
  58 .Pp
  59 The available
  60 .Em kernel configuration
  61 options are:
  62 .Bl -ohang
  63 .It Cd options CONSDEVNAME=string
  64 specifies the name of the console device. Valid values are
  65 .Dq pc
  66 for the pc keyboard / display (default)
  67 and
  68 .Dq com
  69 for a serial port.
  70 .It Cd options CONADDR=integer
  71 sets the base address for the serial console port (default: 0x3f8).
  72 .It Cd options CONSPEED=integer
  73 sets the baudrate for the serial console (default: 9600).
  74 .It Cd options CONS_OVERRIDE
  75 causes console information passed by the bootloader to be ignored and
  76 the settings specified by the three options above (or the defaults) to be
  77 used. Default behaviour is to use the settings from the bootloader if
  78 present, and to use option / default values only if no information was
  79 passed.
  80 .It Cd options CONMODE=integer
  81 allows to specify terminal control flags. The argument is a
  82 .Dq cflag
  83 value, see
  84 .Xr termios 4
  85 for details. Default is
  86 .Li (CREAD | CS8 | HUPCL)
  87 (8N1).
  88 This option takes always effect, because mode settings are not passed
  89 by the bootloader.
  90 .El
  91 .Sh FILES
  92 .Bl -tag -width /dev/console
  93 .It Pa /dev/console
  94 .It Pa /sys/arch/i386/conf/CONFIG
  95 .El
  96 .Sh EXAMPLES
  97 .Cd options CONSDEVNAME=\&"\e"com\e"\&",CONADDR=0x2f8,CONSPEED=57600
  98 .Sh SEE ALSO
  99 .Xr config 1 ,
 100 .Xr tty 4 ,
 101 .Xr boot 8 ,
 102 .Xr boot_console 8
 103 .Sh BUGS
 104 The console device is chosen early in system startup regardless
 105 if the specified driver / device is present in the system configuration file.
 106 If the driver asked for by the bootloader or
 107 .Dq Cd options CONSDEVNAME
 108 is not configured into the system, a panic is caused. Because there is
 109 no console device, no explaining message will be printed.
 110 If the driver is present, but the specific device instance not, kernel
 111 printf will work, but
 112 .Pa /dev/console
 113 becomes a dummy.