Copyright (c) 2004 Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
/usr/sbin/consadm
/usr/sbin/consadm [-a device.\|.\|.] [-p]
/usr/sbin/consadm [-d device.\|.\|.] [-p]
/usr/sbin/consadm [-p]
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 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 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 messages will always continue to be displayed by the default console device.
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 persists for only as long as auxiliary console devices remain active.
See eeprom(8) for instructions on assigning an auxiliary console device as the system console.
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.
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 auxiliary across reboots. When invoked with the -a or -d options, tells the application to make the change persist across reboot.
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 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 auxiliary console devices
The following command prints the name or names of the device or devices currently selected as auxiliary console devices.
example# consadm
Successful completion.
An error occurred.
| ATTRIBUTE TYPE ATTRIBUTE VALUE |
| Stability Level Evolving |
The consadm service is managed by the service management facility, smf(7), under the service identifier:
svc:/system/consadm
Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed using svcadm(8). The service's status can be queried using the svcs(1) command.