Remark (a):

Save this page as vt.html and use the following command to extract the source code with a sample Makefile:
sh -c "( mkdir vt && cd vt && awk '/^<!--eof/{d=0}{if(d)print>f}/^<!--sof/{f=\$2;d=1}' ) < vt.html"

Remark (b):

Some browsers try to be super smart and reformat the html code so you may have trouble to extract the files. This is the right time to learn more about wget, a tool to download files via http or ftp ;-)

Remark (c):

Some versions of nasm are known to generate broken code. I have used nasm-0.98 for this example which worked for me.

This code shows how to control the virtual terminal switching. As a standalone example it doesn't make much sense, but in connection with the framebuffer or ModeX example code it is quite useful.

The switching between the virtual terminals is normally controlled by the kernel. The key combinations ALT-F1, ALT-F2, ..., ALT-CURSORLEFT, ALT-CURSORRIGHT are reserved for that. But it is also possible to tell the kernel that you want to get a signal if the user wants to leave the virtual terminal of your program (in this context it is called release signal) and which signal you want to get when the user switches back to the virtual terminal your program runs on (acquire signal).

In this example SIGUSR1 and SIGUSR2 are used for this purpose. The according handlers are registered with sys_sigaction. Now lets have a closer look how this example works:

• vt_release_handler simply sets vt_flag.
We have no possibility to check if the signal was sent from someone else, so this is all we can do here
• vt_acquire_handler checks if we are on our own virtual terminal, if yes vt_flag gets cleared. If not someone else sent us this signal and we ignore it
• the main work is done in the mainloop it checks if someone pressed enter and looks also periodically for vt_flag if it was changed. If the kernel sent us the release signal it expects a confirmation that we are ready for the switch. In case someone else sent us the signal this confirmation results in an error (because the kernel doesn't know anything about a pending switch). So the result will tell us if the signal was sent because of a pending virtual terminal switch. But this is ugly, because we can only check this after restoring the terminal to its original state. Especially under ModeX this results in a screen flickering if someone else sends us SIGUSR1 and our terminal is active. Look here how mainloop looks in the framebuffer example.

Note:

Instead of tinkering around with the release signal, you can set the release signal in VT_SETMODE to 0, so you won't get one. To still recognize that the user wants to switch the vt, you can enable raw keyboard mode and look yourself for ALT-F1. Use VT_ACTIVATE and VT_WAITACTIVE to switch the vt manually, but you need root rights for this.

It is also possible to place the switch code in the signal handlers itself, but you have to ensure that the underlying program knows that the switch happened to determine if graphics activity is allowed or not.

In the framebuffer and ModeX code we make use of the KDSETMODE ioctl to switch to KD_GRAPHICS. It is not necessary to switch back to KD_TEXT if a terminal switch is going to happen, because the kernel manages this flag for every virtual terminal.

short procedure for handling vt switches:

1. register signal handlers
2. use the VT_GETSTATE ioctl to determine the current virtual terminal (if this fails we are not on local console)
3. tell the kernel via VT_SETMODE which signals to send in case of terminal release and acquire
4. handle incoming signals, in this example done in the mainloop

In this example we use STDIN as file descriptor for sys_ioctl. This is ok as long as nobody redirects it to a file or pipe. If you want that the program even works in this cases: open /dev/tty and use that file descriptor instead.

;****************************************************************************
;****************************************************************************
;*
;* USING VIRTUAL TERMINALS UNDER LINUX
;*
;* written by Karsten Scheibler, 2003-DEC-08
;*
;****************************************************************************
;****************************************************************************
global vt_start
;****************************************************************************
;* some assign's
;****************************************************************************
%assign SYS_IOCTL			54
%assign SYS_SIGACTION			67
%assign SYS_SELECT			142
%assign VT_GETMODE			0x00005601
%assign VT_SETMODE			0x00005602
%assign VT_GETSTATE			0x00005603
%assign VT_RELDISP			0x00005605
%assign VT_PROCESS			1
%assign SIGUSR1				10
%assign SIGUSR2				12
%assign STDIN				0
%assign SA_RESTART			0x10000000
struc 	tvtmode
alignb	4
tvtmode_mode:				resb	1
tvtmode_waitv:				resb	1
tvtmode_relsig:				resw	1
tvtmode_acqsig:				resw	1
tvtmode_frsig:				resw	1
endstruc
%if tvtmode_size != 8
%error "wrong size"
%endif
struc	tvtstat
alignb	4
tvtstat_active:				resw	1
tvtstat_signal:				resw	1
tvtstat_state:				resw	1
endstruc
%if tvtstat_size > 8
%error "wrong size"
%endif
%assign VT_MODE_SAVED			0x00000001
;****************************************************************************
;* data
;****************************************************************************
section .data
align	4
vt_state:				dd	0
vt_flag:				dd	0
section .bss
alignb	4
exit_handler:				resd	1
error_handler:				resd	1
vtmode_data:				resb	tvtmode_size
vtmode_original:			resb	tvtmode_size
vtstat_data:				resb	tvtstat_size
;****************************************************************************
;* vt_start
;****************************************************************************
section .text
vt_start:
xor	dword eax, eax
xor	dword ebx, ebx
call	near  vt_init
;mainloop: this code checks if the user
;pressed enter and checks if we have to switch the virtual terminal
.keypress1:
call	near  vt_check_keypress
cmp	dword eax, byte 1
je	near  vt_end
call	near  vt_check_release
test	dword eax, eax
js	short .keypress1
call	near  vt_commit_release
test	dword eax, eax
js	short .keypress1
.keypress2:
call	near  vt_check_keypress	;vt is not active => no keypress
;possible, we simply use select to
;wait here
call	near  vt_check_acquire
test	dword eax, eax
js	short .keypress2
jmp	short .keypress1
;****************************************************************************
;* vt_init
;****************************************************************************
section .text
vt_init:
mov	dword [exit_handler], eax
mov	dword [error_handler], ebx
;signal handler for release and acquire signal
xor	dword edx, edx
push	dword edx
push	dword SA_RESTART
push	dword edx
push	dword vt_release_handler
mov	dword eax, SYS_SIGACTION
mov	dword ebx, SIGUSR1
mov	dword ecx, esp
int	byte  0x80
add	dword esp, byte 16
test	dword eax, eax
js	near  vt_error
xor	dword edx, edx
push	dword edx
push	dword SA_RESTART
push	dword edx
push	dword vt_acquire_handler
mov	dword eax, SYS_SIGACTION
mov	dword ebx, SIGUSR2
mov	dword ecx, esp
int	byte  0x80
add	dword esp, byte 16
test	dword eax, eax
js	near  vt_error
;get current active virtual terminal
mov	dword eax, SYS_IOCTL
mov	dword ebx, STDIN
mov	dword ecx, VT_GETSTATE
mov	dword edx, vtstat_data
int	byte  0x80
test	dword eax, eax
js	near  vt_error
mov	dword eax, SYS_IOCTL
mov	dword ebx, STDIN
mov	dword ecx, VT_GETMODE
mov	dword edx, vtmode_data
int	byte  0x80
test	dword eax, eax
js	near  vt_error
mov	dword eax, [vtmode_data]
mov	dword ebx, [vtmode_data + 4]
mov	dword [vtmode_original], eax
mov	dword [vtmode_original + 4], ebx
or	dword [vt_state], VT_MODE_SAVED
;tell the kernel which signals to use
mov	byte  [vtmode_data + tvtmode_mode], VT_PROCESS
mov	word  [vtmode_data + tvtmode_relsig], SIGUSR1
mov	word  [vtmode_data + tvtmode_acqsig], SIGUSR2
mov	dword eax, SYS_IOCTL
mov	dword ebx, STDIN
mov	dword ecx, VT_SETMODE
mov	dword edx, vtmode_data
int	byte  0x80
test	dword eax, eax
js	near  vt_error
ret
;****************************************************************************
;* vt_check_keypress
;****************************************************************************
section .text
vt_check_keypress:
push	dword (1 << STDIN)
mov	dword ecx, esp
push	dword 50000		;1/20 second
push	dword 0
mov	dword eax, SYS_SELECT
mov	dword ebx, (STDIN + 1)
xor	dword edx, edx
xor	dword esi, esi
mov	dword edi, esp
int	byte  0x80
add	dword esp, byte 12
ret
;****************************************************************************
;* vt_check_release
;****************************************************************************
section .text
vt_check_release:
xor	dword eax, eax
cmp	dword [vt_flag], byte 1
je	short .release
dec	dword eax
.release:
ret
;****************************************************************************
;* vt_commit_release
;****************************************************************************
section .text
vt_commit_release:
mov	dword eax, SYS_IOCTL
mov	dword ebx, STDIN
mov	dword ecx, VT_RELDISP
mov	dword edx, 1
int	byte  0x80
test	dword eax, eax
jns	short .release
mov	dword [vt_flag], 0
.release:
ret
;****************************************************************************
;* vt_check_acquire
;****************************************************************************
section .text
vt_check_acquire:
xor	dword eax, eax
cmp	dword eax, [vt_flag]
je	short .acquire
dec	dword eax
.acquire:
ret
;****************************************************************************
;* vt_release_handler
;****************************************************************************
section .text
vt_release_handler:
mov	dword [vt_flag], 1
ret
;****************************************************************************
;* vt_acquire_handler
;****************************************************************************
section .text
vt_acquire_handler:
sub	dword esp, byte 8
mov	dword eax, SYS_IOCTL
mov	dword ebx, STDIN
mov	dword ecx, VT_GETSTATE
mov	dword edx, esp
int	byte  0x80
mov	word  bx, [esp + tvtstat_active]
add	dword esp, byte 8
test	dword eax, eax
js	short .no_acquire
cmp	word  bx, [vtstat_data + tvtstat_active]
jne	short .no_acquire
mov	dword [vt_flag], 0
.no_acquire:
ret
;****************************************************************************
;* vt_restore
;****************************************************************************
section .text
vt_restore:
test	dword [vt_state], VT_MODE_SAVED
jz	short .no_mode_saved
mov	dword eax, SYS_IOCTL
mov	dword ebx, STDIN
mov	dword ecx, VT_SETMODE
mov	dword edx, vtmode_original
int	byte  0x80
.no_mode_saved:
ret
;****************************************************************************
;* vt_error
;****************************************************************************
section .text
vt_error:
call	near  vt_restore
xor	dword eax, eax
cmp	dword eax, [error_handler]
je	short .no_handler
jmp	dword [error_handler]
.no_handler:
inc	dword eax
mov	dword ebx, eax
int	byte  0x80
;****************************************************************************
;* vt_end
;****************************************************************************
section .text
vt_end:
call	near  vt_restore
xor	dword eax, eax
cmp	dword eax, [exit_handler]
je	short .no_handler
jmp	dword [exit_handler]
.no_handler:
xor	dword ebx, ebx
inc	dword eax
int	byte  0x80
;*********************************************** 
 This e-mail address is being protected from spam bots, you need JavaScript enabled to view it
  *