GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GRAB_VCSA (1)

NAME

grab_vcsa - Linux console vcsa grabber

CONTENTS

Synopsis
Description
Return Codes
Author

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>
Search for    or go to Top of page |  Section 1 |  Main Index


Free Pascal GRAB_VCSA (1) 22 jan 2006

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.