Manual Pages for UNIX Operating System command usage for man consadm

System Administration Commands                        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 x86 based systems
     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 selec-
     tion  to  persist across reboots the -p option can be speci-
     fied.


     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  console
     device list, though not from the persistent list. While aux-
     iliary console devices may have been removed from the device
     list  receiving  copies  of console messages, those messages
     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



SunOS 5.11          Last change: 27 Oct 2004                    1






System Administration Commands                        consadm(1m)



     as auxiliary console devices remain active.


     See eeprom(1M) for instructions on  assigning  an  auxiliary
     console device as the system console.

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 devices to be added to the  auxiliary
                  console device list.


     -d device    Removes device from the list of auxiliary  con-
                  sole  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



SunOS 5.11          Last change: 27 Oct 2004                    2






System Administration Commands                        consadm(1m)



     Example 3 Printing the list of devices selected as auxiliary
     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 environment
     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                | SUNWcs                      |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
     kmdb(1),  svcs(1),  eeprom(1M),   svcadm(1M),   syslogd(1M),
     environ(5), attributes(5), smf(5), sysmsg(7d), console(7d)

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






SunOS 5.11          Last change: 27 Oct 2004                    3






System Administration Commands                        consadm(1m)



     The consadm service is managed  by  the  service  management
     facility, smf(5), under the service identifier:

       svc:/system/consadm




     Administrative actions on this service,  such  as  enabling,
     disabling,  or  requesting  restart,  can be performed using
     svcadm(1M). The service's status can be  queried  using  the
     svcs(1) command.











































SunOS 5.11          Last change: 27 Oct 2004                    4