conscontrol(8) [freebsd man page]
CONSCONTROL(8) BSD System Manager's Manual CONSCONTROL(8) NAME
conscontrol -- control physical console devices SYNOPSIS
conscontrol [list] conscontrol mute on | off conscontrol add | delete console conscontrol set | unset console DESCRIPTION
The conscontrol utility is used to examine and modify the physical devices which back the virtual console devices. If no arguments (or only the list command) are specified, the current console settings are shown. There are two types of logical consoles; a high level console which is represented by /dev/console, and a low level console. The low level console is used for kernel printf(9) and ddb(4) debugger support, while the high level console is used by user programs like syslogd(8). Multiple device support is implemented only for the low level console; the high level console is set to the first device in the console list. Multiple console support may be invoked by passing the kernel the -D flag from the boot loader, or by using conscontrol to change the list of console devices after the system has booted. The following options are available: add | delete console Add or delete a physical device from the logical console. The device must support low-level console operations. Adding a device will place it at the front of the list of console devices; the first device is used for the high level console. The console argument is the name of a console device in /dev; the name of the directory may be omitted. mute on | off Change the state of console muting. All console output is suppressed when console muting is on. set | unset console Set or unset the virtual console. When unset, output from the system, such as the kernel printf(9), always goes out to the real main console. When set, it goes to another. This is an interface to the tty ioctl TIOCCONS. SEE ALSO
sio(4), syscons(4), tty(4), vt(4), boot(8), loader(8) HISTORY
The conscontrol utility first appeared in FreeBSD 5.0. AUTHORS
Jonathan Lemon BSD
April 14, 2011 BSD
Check Out this Related Man Page
consadm(1m) System Administration Commands consadm(1m) NAME
consadm - select or display devices used as auxiliary console 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 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 con- sole 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(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 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 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 per- sistent 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 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 attributes: +-----------------------------+-----------------------------+ |ATTRIBUTE TYPE |ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ |Stability Level |Evolving | +-----------------------------+-----------------------------+ SEE ALSO
svcs(1), eeprom(1M), svcadm(1M), syslogd(1M), kadb(1M), environ(5), attributes(5), smf(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. 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 ser- vice's status can be queried using the svcs(1) command. SunOS 5.10 27 Oct 2004 consadm(1m)