consadm(1M)

NAME

     consadm - select or display devices used as  auxiliary  con-
     sole devices

SYNOPSIS

     /usr/sbin/consadm

     /usr/sbin/consadm [-a  device ...] [-p]

     /usr/sbin/consadm [-d device ...] [-p]

     /usr/sbin/consadm [-p]

DESCRIPTION

     consadm selects the hardware device or devices to be used as
     auxiliary  console  devices, or displays the current device.
     Only superusers are allowed to  make  or  display  auxiliary
     console device selections.

     Auxiliary console devices receive  copies  of  console  mes-
     sages,  and  can  be  used as the console during single user
     mode.  In particular, they receive kernel messages and  mes-
     sages  directed to /dev/sysmsg. On Solaris or x86 based sys-
     tems  they  can  also  be  used  for  interaction  with  the
     bootstrap.

     By default, selecting a display device to be used as an aux-
     iliary  console  device selects that device for the duration
     the system remains  up.   If  the  administrator  needs  the
     selection  to  persist  across  reboots the -p option can be
     specified.

      consadm runs a daemon in the background, monitoring auxili-
     ary  console  devices.   Any  devices  that are disconnected
     (hang up, lose carrier) are removed from the auxiliary  con-
     sole device list, though not from the persistent list. While
     auxiliary console devices may have  been  removed  from  the
     device list receiving copies of console messages, those mes-
     sages will always continue to be displayed  by  the  default
     console device.

     The daemon will not run if it finds there are not any  auxi-
     liary  devices  configured to monitor.   Likewise, after the
     last auxiliary console is  removed,  the  daemon  will  shut
     itself  down.    Therefore  the  daemon persists for only as
     long as auxiliary console devices remain active.

OPTIONS

     The following options are supported:

     -a device
            Adds device to the list of auxiliary console devices.

           Specify  device as the path name to the device or dev-
           ices to be added to the auxiliary console device list.

     -d device
            Removes device from the  list  of  auxiliary  console
           devices. Specify device as the path name to the device
           or devices to be removed from  the  auxiliary  console
           device list.

     -p    Prints the list of auxiliary  consoles  that  will  be
           auxiliary across reboots.

           When invoked with the -a or -d  options  ,  tells  the
           application to make the change persist across reboot.

EXAMPLES

     Example 1: Adding to the list of devices that  will  receive
     console messages

     The following command adds /dev/term/a to the list  of  dev-
     ices that will receive console messages.

     example# consadm -a /dev/term/a

     Example 2: Removing from  the  list  of  devices  that  will
     receive console messages

     The following command removes /dev/term/a from the  list  of
     devices  that  will  receive console messages. This includes
     removal from the persistent list.

     example# consadm -d -p /dev/term/a

     Example 3: Printing the list of devices selected as  auxili-
     ary console devices

     The following command prints the name or names of the device
     or devices currently selected as auxiliary console devices.

     example# consadm

ENVIRONMENT VARIABLES

     See environ(5)  for descriptions of the  following  environ-
     ment  variables  that  affect  the   execution  of  consadm:
     LC_CTYPE, LC_MESSAGES, and NLSPATH.

EXIT STATUS

     The following exit values are returned:

     0     Successful completion.

     >0    An error occurred.

ATTRIBUTES

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

     ____________________________________________________________
    | ATTRIBUTE TYPE              | ATTRIBUTE VALUE             |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|
    | Stability Level             | Evolving                    |
    |_____________________________|_____________________________|

SEE ALSO

     eeprom(1M),  syslogd(1M),   kadb(1M),   environ(5),   attri-
     butes(5), sysmsg(7d), console(7d)

NOTES

     Auxiliary  console  devices  are  not  usable  for  kadb  or
     firmware  I/O,  do  not  receive  panic messages, and do not
     receive output directed to /dev/console.