setterm - set terminal attributes


   setterm [options]


   setterm  writes  to standard output a character string that will invoke
   the  specified  terminal  capabilities.   Where  possible  terminfo  is
   consulted  to  find  the  string  to use.  Some options however (marked
   "virtual consoles only" below)  do  not  correspond  to  a  terminfo(5)
   capability.  In this case, if the terminal type is "con" or "linux" the
   string that invokes the specified capabilities on the PC Minix  virtual
   console  driver  is  output.   Options  that are not implemented by the
   terminal are ignored.


   For boolean options (on or off), the default is on.

   Below, an 8-color can be black,  red,  green,  yellow,  blue,  magenta,
   cyan, or white.

   A  16-color  can  be  an  8-color,  or grey, or bright followed by red,
   green, yellow, blue, magenta, cyan, or white.

   The various color options may be set independently, at least on virtual
   consoles,  though  the  results of setting multiple modes (for example,
   --underline and --half-bright) are hardware-dependent.

   --appcursorkeys [on|off]  (virtual consoles only)
          Sets Cursor Key Application Mode on or off.  When on, ESC  O  A,
          ESC O B, etc.  will be sent for the cursor keys instead of ESC [
          A, ESC [ B, etc.  See the vi  and  Cursor-Keys  section  of  the
          Text-Terminal-HOWTO  for  how  this  can  cause  problems for vi

   --append [console_number]
          Like --dump,  but  appends  to  the  snapshot  file  instead  of
          overwriting it.  Only works if no --dump options are given.

   --background 8-color|default
          Sets the background text color.

   --blank [0-60|force|poke]  (virtual consoles only)
          Sets  the  interval  of  inactivity, in minutes, after which the
          screen will be automatically blanked (using APM  if  available).
          Without  an argument, it gets the blank status (returns which vt
          was blanked, or zero for an unblanked vt).

          The force option keeps  the  screen  blank  even  if  a  key  is

          The poke option unblanks the screen.

   --bfreq [number]  (virtual consoles only)
          Sets  the  bell  frequency  in  Hertz.   Without an argument, it
          defaults to 0.

   --blength [0-2000]  (virtual consoles only)
          Sets the bell duration in milliseconds.  Without an argument, it
          defaults to 0.

   --blink [on|off]
          Turns  blink  mode  on  or  off.   Except  on a virtual console,
          --blink off turns off  all  attributes  (bold,  half-brightness,
          blink, reverse).

   --bold [on|off]
          Turns  bold  (extra bright) mode on or off.  Except on a virtual
          console, --bold  off  turns  off  all  attributes  (bold,  half-
          brightness, blink, reverse).

   --clear [all|rest]
          Without  an argument or with the argument all, the entire screen
          is cleared and the cursor is set to the home position, just like
          clear(1)  does.   With  the argument rest, the screen is cleared
          from the current cursor position to the end.

   --clrtabs [tab1 tab2 tab3 ...]  (virtual consoles only)
          Clears tab stops from the given horizontal cursor positions,  in
          the range 1-160.  Without arguments, it clears all tab stops.

   --cursor [on|off]
          Turns the terminal's cursor on or off.

          Sets the terminal's rendering options to the default values.

   --dump [console_number]
          Writes  a  snapshot of the virtual console with the given number
          to the file specified with the --file  option,  overwriting  its
          contents;  the  default is screen.dump.  Without an argument, it
          dumps the current virtual console.  This overrides --append.

   --file filename
          Sets the snapshot file name for any --dump or  --append  options
          on  the  same  command line.  If this option is not present, the
          default is screen.dump in the current directory.   A  path  name
          that  exceeds the system maximum will be truncated, see PATH_MAX
          from linux/limits.h for the value.

   --foreground 8-color|default
          Sets the foreground text color.

   --half-bright [on|off]
          Turns dim (half-brightness) mode on or off.  Except on a virtual
          console, --half-bright off turns off all attributes (bold, half-
          brightness, blink, reverse).

   --hbcolor 16-color
          Sets the color for bold characters.

          Displays the terminal  initialization  string,  which  typically
          sets  the  terminal's rendering options, and other attributes to
          the default values.

   --inversescreen [on|off]
          Swaps foreground and background colors for the whole screen.

   --linewrap [on|off]
          Makes the terminal continue on a new line when a line is full.

   --msg [on|off]  (virtual consoles only)
          Enables or disables the sending of kernel printk()  messages  to
          the console.

   --msglevel 0-8  (virtual consoles only)
          Sets  the  console  logging  level for kernel printk() messages.
          All messages strictly more important than this will be  printed,
          so  a  logging  level of 0 has the same effect as --msg on and a
          logging level of 8 will print all kernel messages.  klogd(8) may
          be  a  more  convenient  interface  to  the  logging  of  kernel

   --powerdown [0-60]
          Sets  the  VESA  powerdown  interval  in  minutes.   Without  an
          argument,  it defaults to 0 (disable powerdown).  If the console
          is blanked or the monitor is in suspend mode, then  the  monitor
          will  go  into vsync suspend mode or powerdown mode respectively
          after this period of time has elapsed.

   --powersave off
          Turns off monitor VESA powersaving features.

   --powersave on|vsync
          Puts the monitor into VESA vsync suspend mode.

   --powersave powerdown
          Puts the monitor into VESA powerdown mode.

   --powersave hsync
          Puts the monitor into VESA hsync suspend mode.

   --regtabs [1-160]  (virtual consoles only)
          Clears all tab stops, then sets a regular tab stop pattern, with
          one  tab  every  specified  number  of  positions.   Without  an
          argument, it defaults to 8.

   --repeat [on|off]  (virtual consoles only)
          Turns keyboard repeat on or off.

          Displays the terminal reset string, which typically  resets  the
          terminal to its power-on state.

   --reverse [on|off]
          Turns  reverse  video  mode  on  or  off.   Except  on a virtual
          console, --reverse off turns off  all  attributes  (bold,  half-
          brightness, blink, reverse).

   --store  (virtual consoles only)
          Stores  the terminal's current rendering options (foreground and
          background colors) as the values to be used at reset-to-default.

   --tabs [tab1 tab2 tab3 ...]
          Sets tab stops at the given horizontal cursor positions, in  the
          range  1-160.   Without arguments, it shows the current tab stop

   --term terminal_name
          Overrides the TERM environment variable.

   --ulcolor 16-color  (virtual consoles only)
          Sets the color for underlined characters.

   --underline [on|off]
          Turns underline mode on or off.

          Displays version information and exits.

   --help Displays a help text and exits.


   Since version 2.25 setterm  has  support  for  long  options  with  two
   hyphens,  for example --help, beside the historical long options with a
   single hyphen, for example -help.  In scripts it is better to  use  the
   backward-compatible  single  hyphen  rather  than  the  double  hyphen.
   Currently there are no plans nor good reasons  to  discontinue  single-
   hyphen compatibility.


   tput(1), stty(1), terminfo(5), tty(4)


   Differences between the Minix and Linux versions are not documented.


   The  setterm command is part of the util-linux package and is available
   from Linux Kernel  Archive

More Linux Commands

XtSessionReturnToken(3) - token management for checkpointing
The XtSessionGetToken function will return NULL if the checkpoint operation instigated by the session manager is not currently under way. To indicate the comple

gtester-report(1) - test report formatting utility (ManPage)
gtester-report is a script which converts the XML output generated by gtester into HTML. OPTIONS -h, --help print help and exit -v, --version print version info

preadv(2) - read or write data into multiple buffers........
The readv() system call reads iovcnt buffers from the file associated with the file descriptor fd into the buffers described by iov (scatter input). The writev(

Search::Dict(3pm) - search for key in dictionary file.......
Sets file position in FILEHANDLE to be first line greater than or equal (stringwise) to $key. Returns the new file position, or -1 if an error occurs. The flags

bell(n) - Ring a display's bell (Local - Linux man page)....
This command rings the bell on the display for window and returns an empty string. If the -displayof option is omitted, the display of the applications main win

crypt(3) - password hashing (Library - Linux man page)......
The crypt, crypt_r, crypt_rn, and crypt_ra functions calculate a cryptographic hash function of key with one of a number of supported methods as requested with

iwevent(8) - Display Wireless Events generated by drivers an
iwevent displays Wireless Events received through the RTNetlink socket. Each line displays the specific Wireless Event which describes what has happened on the

XConvertCase(3) - convert keysyms - Linux manual page.......
Standard KeySym names are obtained from <X11/keysymdef.h> by removing the XK_ prefix from each name. KeySyms that are not part of the Xlib standard also may be

ExtUtils::Manifest(3pm) - utilities to write and check a MAN
Functions ExtUtils::Manifest exports no functions by default. The following are exported on request mkmanifest mkmanifest(); Writes all files in and below the c

XkbGetDeviceInfo(3) - Determine whether the X server allows
To determine whether the X server allows Xkb access to particular capabilities of input devices other than the core X keyboard, or to determine the status of in

Module::Build::Platform::Default(3pm) - Stub class for unkno
Module::Build::Platform::Default.3pm - The sole purpose of this module is to inherit from Module::Build::Base. Please see the Module::Build for the docs. AUTHOR

XrmOptionKind(3) - initialize the Resource Manager, Resource
The XrmInitialize function initialize the resource manager. It must be called before any other Xrm functions are used. The XrmParseCommand function parses an (a

We can't live, work or learn in freedom unless the software we use is free.