consadm man page on SmartOS

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

CONSADM(1M)							   CONSADM(1M)

       consadm - select or display devices used as auxiliary console devices


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

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

       /usr/sbin/consadm [-p]

       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 messages, and can
       be used as the console during single user  mode.	 In  particular,  they
       receive	kernel	messages  and  messages	 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 auxiliary con‐
       sole 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  auxiliary  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 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

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

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

       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 console devices.
		    Specify  device  as the path name to the device or devices
		    to be removed from the auxiliary console device list.

		    Prints the list of auxiliary consoles that will be	auxil‐
		    iary across reboots.

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

       Example 1 Adding to the list of devices that will receive console  mes‐

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

	 example# consadm -a /dev/term/a

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

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

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

       Example	3  Printing  the list of devices selected as auxiliary console

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

	 example# consadm

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

       The following exit values are returned:

	     Successful completion.

	     An error occurred.

       See attributes(5) for descriptions of the following attributes:

       │Stability Level │ Evolving	  │

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

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

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


       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.

				 Oct 27, 2004			   CONSADM(1M)

List of man pages available for SmartOS

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