NAME
grab_vcsa - Linux console vcsa grabber
SYNOPSIS
grab_vcsa
DESCRIPTION
The Linux console allows text mode video buffer access^. For each tty
device (/dev/tty0..31) there exist two devices (/dev/vcs0..31) and
(/dev/vcsa0..31). These devices are two different representations of
the content of the console.
When you login on the Linux console, your tty device is changed owner
to you, so you can read/write it. When you logout it is takes from you.
This does not happen with the vcs and vcsa devices, i.e. you cannot
access the video buffer of your own tty.
Unfortunately there is a lot of reason to use the text mode video
buffer. For instance, it is not possible to get access to the full 256
characters the VGA adapter can display without using the text mode
video buffer (Linux emulates the vt100 character set which does not
have all VGA characters). This annoyance severely limits the porting
possibilities to Linux of software that was written with a VGA
character set in mind.
grab_vcsa is a setuid root program that, when called will change the
owner of the vcs and vcsa devices to you, after a series of security
checks have been performed.
It is not necessary to change the permissions back again (this would be
pointless since a user could kill a imaginary release_vcsa program
before it can do its work). The permissions are automatically reverted
on logout.
grab_vcsa is used by the Free Pascal video unit. The video unit allows
programmers to develop portable programs accross Dos, Linux, FreeBSD,
Windows, OS/2 and other operating systems while they can still assume
being able to use the full VGA character set.
RETURN CODES
grab_vcsa has the following return codes:
0 Success
1 You are not running on the Linux console
2 Error while statting tty.
3 Error while executing chown.
4 Error while executing chmod.
4 You do not own your own tty.
AUTHOR
Daniel Mantione <daniel.mantione@freepascal.org>