2004-11-03 13:51:07 +00:00
|
|
|
.\" Copyright (c) 1995 James R. Van Zandt <jrv@vanzandt.mv.com>
|
|
|
|
.\" Sat Feb 18 09:11:07 EST 1995
|
|
|
|
.\"
|
|
|
|
.\" This is free documentation; you can redistribute it and/or
|
|
|
|
.\" modify it under the terms of the GNU General Public License as
|
|
|
|
.\" published by the Free Software Foundation; either version 2 of
|
|
|
|
.\" the License, or (at your option) any later version.
|
|
|
|
.\"
|
|
|
|
.\" The GNU General Public License's references to "object code"
|
|
|
|
.\" and "executables" are to be interpreted as the output of any
|
|
|
|
.\" document formatting or typesetting system, including
|
|
|
|
.\" intermediate and printed output.
|
|
|
|
.\"
|
|
|
|
.\" This manual is distributed in the hope that it will be useful,
|
|
|
|
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
.\" GNU General Public License for more details.
|
|
|
|
.\"
|
|
|
|
.\" You should have received a copy of the GNU General Public
|
|
|
|
.\" License along with this manual; if not, write to the Free
|
|
|
|
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
|
|
|
|
.\" USA.
|
|
|
|
.\"
|
|
|
|
.\" Modified, Sun Feb 26 15:08:05 1995, faith@cs.unc.edu
|
2007-12-17 14:52:20 +00:00
|
|
|
.\" 2007-12-17, Samuel Thibault <samuel.thibault@ens-lyon.org>:
|
|
|
|
.\" document the VT_GETHIFONTMASK ioctl
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" "
|
2007-12-17 14:52:20 +00:00
|
|
|
.TH VCS 4 2007-12-17 "Linux" "Linux Programmer's Manual"
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH NAME
|
|
|
|
vcs, vcsa \- virtual console memory
|
|
|
|
.SH DESCRIPTION
|
2005-11-02 13:55:25 +00:00
|
|
|
\fI/dev/vcs0\fP is a character device with major number 7 and minor number
|
2007-04-12 22:42:49 +00:00
|
|
|
0, usually of mode 0644 and owner root.tty.
|
|
|
|
It refers to the memory of the currently
|
2004-11-03 13:51:07 +00:00
|
|
|
displayed virtual console terminal.
|
|
|
|
.LP
|
2005-11-02 13:55:25 +00:00
|
|
|
\fI/dev/vcs[1\-63]\fP are character devices for virtual console
|
2004-11-03 13:51:07 +00:00
|
|
|
terminals, they have major number 7 and minor number 1 to 63, usually
|
2007-05-12 13:26:09 +00:00
|
|
|
mode 0644 and owner root.tty.
|
|
|
|
\fI/dev/vcsa[0\-63]\fP are the same, but
|
2007-12-29 15:01:28 +00:00
|
|
|
using
|
|
|
|
.IR "unsigned short" s
|
|
|
|
(in host byte order) that include attributes,
|
2007-12-17 14:52:20 +00:00
|
|
|
and prefixed with four bytes giving the screen
|
2004-11-03 13:51:07 +00:00
|
|
|
dimensions and cursor position: \fIlines\fP, \fIcolumns\fP, \fIx\fP, \fIy\fP.
|
|
|
|
(\fIx\fP = \fIy\fP = 0 at the top left corner of the screen.)
|
2007-12-17 14:52:20 +00:00
|
|
|
|
|
|
|
When a 512-character font is loaded,
|
2007-12-20 12:12:32 +00:00
|
|
|
the 9th bit position can be fetched by applying the
|
2007-12-17 14:52:20 +00:00
|
|
|
.BR ioctl (2)
|
|
|
|
\fBVT_GETHIFONTMASK\fP operation
|
|
|
|
(available in Linux kernels 2.6.18 and above)
|
|
|
|
on \fI/dev/tty[1\-63]\fP;
|
|
|
|
the value is returned in the
|
|
|
|
.I "unsigned short"
|
|
|
|
pointed to by the third
|
|
|
|
.BR ioctl (2)
|
|
|
|
argument.
|
2004-11-03 13:51:07 +00:00
|
|
|
.PP
|
2007-12-17 14:52:20 +00:00
|
|
|
These devices replace the screendump
|
|
|
|
.BR ioctl (2)
|
|
|
|
operations of
|
2007-05-12 09:06:04 +00:00
|
|
|
.BR console (4),
|
|
|
|
so the system
|
2004-11-03 13:51:07 +00:00
|
|
|
administrator can control access using file system permissions.
|
|
|
|
.PP
|
|
|
|
The devices for the first eight virtual consoles may be created by:
|
|
|
|
|
|
|
|
.nf
|
2007-04-12 22:42:49 +00:00
|
|
|
for x in 0 1 2 3 4 5 6 7 8; do
|
2006-05-22 19:44:47 +00:00
|
|
|
mknod \-m 644 /dev/vcs$x c 7 $x;
|
|
|
|
mknod \-m 644 /dev/vcsa$x c 7 $[$x+128];
|
|
|
|
done
|
|
|
|
chown root:tty /dev/vcs*
|
2004-11-03 13:51:07 +00:00
|
|
|
.fi
|
2007-12-17 16:20:31 +00:00
|
|
|
|
|
|
|
No
|
|
|
|
.BR ioctl (2)
|
|
|
|
requests are supported.
|
2007-05-19 04:30:20 +00:00
|
|
|
.SH FILES
|
|
|
|
/dev/vcs[0\-63]
|
|
|
|
.br
|
|
|
|
/dev/vcsa[0\-63]
|
2007-06-08 12:01:06 +00:00
|
|
|
.\" .SH AUTHOR
|
|
|
|
.\" Andries Brouwer <aeb@cwi.nl>
|
2007-05-19 04:30:20 +00:00
|
|
|
.SH VERSIONS
|
|
|
|
Introduced with version 1.1.92 of the Linux kernel.
|
2006-05-22 19:44:47 +00:00
|
|
|
.SH EXAMPLE
|
2007-04-12 22:42:49 +00:00
|
|
|
You may do a screendump on vt3 by switching to vt1 and typing
|
2007-04-24 16:44:51 +00:00
|
|
|
\fIcat /dev/vcs3 >foo\fP.
|
|
|
|
Note that the output does not contain
|
2004-11-03 13:51:07 +00:00
|
|
|
newline characters, so some processing may be required, like
|
2005-07-06 07:41:37 +00:00
|
|
|
in \fIfold \-w 81 /dev/vcs3 | lpr\fP or (horrors)
|
|
|
|
\fIsetterm \-dump 3 \-file /proc/self/fd/1\fP.
|
2004-11-03 13:51:07 +00:00
|
|
|
.LP
|
|
|
|
The \fI/dev/vcsa0\fP device is used for Braille support.
|
|
|
|
|
|
|
|
This program displays the character and screen attributes under the
|
|
|
|
cursor of the second virtual console, then changes the background color
|
|
|
|
there:
|
|
|
|
|
|
|
|
.nf
|
2007-04-05 12:36:57 +00:00
|
|
|
#include <unistd.h>
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <stdio.h>
|
|
|
|
#include <fcntl.h>
|
2007-12-17 14:52:20 +00:00
|
|
|
#include <sys/ioctl.h>
|
|
|
|
#include <linux/vt.h>
|
2004-11-03 13:51:07 +00:00
|
|
|
|
2007-04-12 22:42:49 +00:00
|
|
|
int
|
|
|
|
main(void)
|
2007-04-05 12:36:57 +00:00
|
|
|
{
|
|
|
|
int fd;
|
|
|
|
char *device = "/dev/vcsa2";
|
2007-12-17 14:52:20 +00:00
|
|
|
char *console = "/dev/tty2";
|
2007-04-05 12:36:57 +00:00
|
|
|
struct {unsigned char lines, cols, x, y;} scrn;
|
2007-12-17 14:52:20 +00:00
|
|
|
unsigned short s;
|
|
|
|
unsigned short mask;
|
|
|
|
unsigned char ch, attrib;
|
2004-11-03 13:51:07 +00:00
|
|
|
|
2007-12-17 14:52:20 +00:00
|
|
|
fd = open(console, O_RDWR);
|
|
|
|
if (fd < 0) {
|
|
|
|
perror(console);
|
|
|
|
exit(EXIT_FAILURE);
|
|
|
|
}
|
|
|
|
if (ioctl(fd, VT_GETHIFONTMASK, &mask) < 0) {
|
|
|
|
perror("VT_GETHIFONTMASK");
|
|
|
|
exit(EXIT_FAILURE);
|
|
|
|
}
|
|
|
|
(void) close(fd);
|
2007-04-05 12:36:57 +00:00
|
|
|
fd = open(device, O_RDWR);
|
|
|
|
if (fd < 0) {
|
|
|
|
perror(device);
|
2007-06-01 05:23:59 +00:00
|
|
|
exit(EXIT_FAILURE);
|
2006-05-22 19:44:47 +00:00
|
|
|
}
|
2007-04-05 12:36:57 +00:00
|
|
|
(void) read(fd, &scrn, 4);
|
|
|
|
(void) lseek(fd, 4 + 2*(scrn.y*scrn.cols + scrn.x), 0);
|
2007-12-17 14:52:20 +00:00
|
|
|
(void) read(fd, &s, 2);
|
|
|
|
ch = s & 0xff;
|
|
|
|
if (attrib & mask)
|
|
|
|
ch |= 0x100;
|
|
|
|
attrib = ((s & ~mask) >> 8);
|
2008-06-09 15:49:35 +00:00
|
|
|
printf("ch=\(aq%c\(aq attrib=0x%02x\\n", ch, attrib);
|
2007-04-05 12:36:57 +00:00
|
|
|
attrib ^= 0x10;
|
|
|
|
(void) lseek(fd, \-1, 1);
|
|
|
|
(void) write(fd, &attrib, 1);
|
2007-05-16 02:09:09 +00:00
|
|
|
exit(EXIT_SUCCESS);
|
2007-04-05 12:36:57 +00:00
|
|
|
}
|
2004-11-03 13:51:07 +00:00
|
|
|
.fi
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR console (4),
|
|
|
|
.BR tty (4),
|
2008-06-28 04:23:26 +00:00
|
|
|
.BR ttyS (4),
|
|
|
|
.BR gpm (8)
|