1 // SPDX-License-Identifier: GPL-2.0
3 * Provide access to virtual console memory.
4 * /dev/vcs0: the screen as it is being viewed right now (possibly scrolled)
5 * /dev/vcsN: the screen of /dev/ttyN (1 <= N <= 63)
8 * /dev/vcsaN: idem, but including attributes, and prefixed with
9 * the 4 bytes lines,columns,x,y (as screendump used to give).
10 * Attribute/character pair is in native endianity.
13 * This replaces screendump and part of selection, so that the system
14 * administrator can control access using file system permissions.
16 * aeb@cwi.nl - efter Friedas begravelse - 950211
18 * machek@k332.feld.cvut.cz - modified not to send characters to wrong console
19 * - fixed some fatal off-by-one bugs (0-- no longer == -1 -> looping and looping and looping...)
20 * - making it shorter - scr_readw are macros which expand in PRETTY long code
23 #include <linux/kernel.h>
24 #include <linux/major.h>
25 #include <linux/errno.h>
26 #include <linux/export.h>
27 #include <linux/tty.h>
28 #include <linux/interrupt.h>
30 #include <linux/init.h>
31 #include <linux/vt_kern.h>
32 #include <linux/selection.h>
33 #include <linux/kbd_kern.h>
34 #include <linux/console.h>
35 #include <linux/device.h>
36 #include <linux/sched.h>
38 #include <linux/poll.h>
39 #include <linux/signal.h>
40 #include <linux/slab.h>
41 #include <linux/notifier.h>
43 #include <linux/uaccess.h>
44 #include <asm/byteorder.h>
45 #include <asm/unaligned.h>
52 #define CON_BUF_SIZE (CONFIG_BASE_SMALL ? 256 : PAGE_SIZE)
54 struct vcs_poll_data
{
55 struct notifier_block notifier
;
56 unsigned int cons_num
;
57 bool seen_last_update
;
58 wait_queue_head_t waitq
;
59 struct fasync_struct
*fasync
;
63 vcs_notifier(struct notifier_block
*nb
, unsigned long code
, void *_param
)
65 struct vt_notifier_param
*param
= _param
;
66 struct vc_data
*vc
= param
->vc
;
67 struct vcs_poll_data
*poll
=
68 container_of(nb
, struct vcs_poll_data
, notifier
);
69 int currcons
= poll
->cons_num
;
71 if (code
!= VT_UPDATE
)
75 currcons
= fg_console
;
78 if (currcons
!= vc
->vc_num
)
81 poll
->seen_last_update
= false;
82 wake_up_interruptible(&poll
->waitq
);
83 kill_fasync(&poll
->fasync
, SIGIO
, POLL_IN
);
88 vcs_poll_data_free(struct vcs_poll_data
*poll
)
90 unregister_vt_notifier(&poll
->notifier
);
94 static struct vcs_poll_data
*
95 vcs_poll_data_get(struct file
*file
)
97 struct vcs_poll_data
*poll
= file
->private_data
, *kill
= NULL
;
102 poll
= kzalloc(sizeof(*poll
), GFP_KERNEL
);
105 poll
->cons_num
= iminor(file_inode(file
)) & 127;
106 init_waitqueue_head(&poll
->waitq
);
107 poll
->notifier
.notifier_call
= vcs_notifier
;
108 if (register_vt_notifier(&poll
->notifier
) != 0) {
114 * This code may be called either through ->poll() or ->fasync().
115 * If we have two threads using the same file descriptor, they could
116 * both enter this function, both notice that the structure hasn't
117 * been allocated yet and go ahead allocating it in parallel, but
118 * only one of them must survive and be shared otherwise we'd leak
119 * memory with a dangling notifier callback.
121 spin_lock(&file
->f_lock
);
122 if (!file
->private_data
) {
123 file
->private_data
= poll
;
125 /* someone else raced ahead of us */
127 poll
= file
->private_data
;
129 spin_unlock(&file
->f_lock
);
131 vcs_poll_data_free(kill
);
137 * Returns VC for inode.
138 * Must be called with console_lock.
140 static struct vc_data
*
141 vcs_vc(struct inode
*inode
, int *viewed
)
143 unsigned int currcons
= iminor(inode
) & 127;
145 WARN_CONSOLE_UNLOCKED();
148 currcons
= fg_console
;
156 return vc_cons
[currcons
].d
;
160 * Returns size for VC carried by inode.
161 * Must be called with console_lock.
164 vcs_size(struct inode
*inode
)
167 int minor
= iminor(inode
);
170 WARN_CONSOLE_UNLOCKED();
172 vc
= vcs_vc(inode
, NULL
);
176 size
= vc
->vc_rows
* vc
->vc_cols
;
179 size
= 2*size
+ HEADER_SIZE
;
183 static loff_t
vcs_lseek(struct file
*file
, loff_t offset
, int orig
)
188 size
= vcs_size(file_inode(file
));
192 return fixed_size_llseek(file
, offset
, orig
, size
);
197 vcs_read(struct file
*file
, char __user
*buf
, size_t count
, loff_t
*ppos
)
199 struct inode
*inode
= file_inode(file
);
200 unsigned int currcons
= iminor(inode
);
202 struct vcs_poll_data
*poll
;
205 int col
, maxcol
, viewed
;
206 unsigned short *org
= NULL
;
210 con_buf
= (char *) __get_free_page(GFP_KERNEL
);
216 /* Select the proper current console and verify
217 * sanity of the situation under the console lock.
221 attr
= (currcons
& 128);
223 vc
= vcs_vc(inode
, &viewed
);
230 poll
= file
->private_data
;
232 poll
->seen_last_update
= true;
236 char *con_buf0
, *con_buf_start
;
237 long this_round
, size
;
241 /* Check whether we are above size each round,
242 * as copy_to_user at the end of this loop
245 size
= vcs_size(inode
);
254 if (count
> size
- pos
)
258 if (this_round
> CON_BUF_SIZE
)
259 this_round
= CON_BUF_SIZE
;
261 /* Perform the whole read into the local con_buf.
262 * Then we can drop the console spinlock and safely
263 * attempt to move it to userspace.
266 con_buf_start
= con_buf0
= con_buf
;
267 orig_count
= this_round
;
268 maxcol
= vc
->vc_cols
;
270 org
= screen_pos(vc
, p
, viewed
);
273 while (this_round
-- > 0) {
274 *con_buf0
++ = (vcs_scr_readw(vc
, org
++) & 0xff);
275 if (++col
== maxcol
) {
276 org
= screen_pos(vc
, p
, viewed
);
282 if (p
< HEADER_SIZE
) {
285 con_buf0
[0] = (char)vc
->vc_rows
;
286 con_buf0
[1] = (char)vc
->vc_cols
;
287 getconsxy(vc
, con_buf0
+ 2);
291 if (this_round
> CON_BUF_SIZE
) {
292 this_round
= CON_BUF_SIZE
;
293 orig_count
= this_round
- p
;
296 tmp_count
= HEADER_SIZE
;
297 if (tmp_count
> this_round
)
298 tmp_count
= this_round
;
300 /* Advance state pointers and move on. */
301 this_round
-= tmp_count
;
303 con_buf0
= con_buf
+ HEADER_SIZE
;
304 /* If this_round >= 0, then p is even... */
306 /* Skip first byte for output if start address is odd
307 * Update region sizes up/down depending on free
311 if (this_round
< CON_BUF_SIZE
)
316 if (this_round
> 0) {
317 unsigned short *tmp_buf
= (unsigned short *)con_buf0
;
323 org
= screen_pos(vc
, p
, viewed
);
326 /* Buffer has even length, so we can always copy
327 * character + attribute. We do not copy last byte
328 * to userspace if this_round is odd.
330 this_round
= (this_round
+ 1) >> 1;
333 *tmp_buf
++ = vcs_scr_readw(vc
, org
++);
335 if (++col
== maxcol
) {
336 org
= screen_pos(vc
, p
, viewed
);
344 /* Finally, release the console semaphore while we push
345 * all the data to userspace from our temporary buffer.
347 * AKPM: Even though it's a semaphore, we should drop it because
348 * the pagefault handling code may want to call printk().
352 ret
= copy_to_user(buf
, con_buf_start
, orig_count
);
356 read
+= (orig_count
- ret
);
370 free_page((unsigned long) con_buf
);
375 vcs_write(struct file
*file
, const char __user
*buf
, size_t count
, loff_t
*ppos
)
377 struct inode
*inode
= file_inode(file
);
378 unsigned int currcons
= iminor(inode
);
381 long attr
, size
, written
;
383 int col
, maxcol
, viewed
;
384 u16
*org0
= NULL
, *org
= NULL
;
388 con_buf
= (char *) __get_free_page(GFP_KERNEL
);
394 /* Select the proper current console and verify
395 * sanity of the situation under the console lock.
399 attr
= (currcons
& 128);
401 vc
= vcs_vc(inode
, &viewed
);
405 size
= vcs_size(inode
);
407 if (pos
< 0 || pos
> size
)
409 if (count
> size
- pos
)
413 long this_round
= count
;
417 if (this_round
> CON_BUF_SIZE
)
418 this_round
= CON_BUF_SIZE
;
420 /* Temporarily drop the console lock so that we can read
421 * in the write data from userspace safely.
424 ret
= copy_from_user(con_buf
, buf
, this_round
);
430 /* Abort loop if no data were copied. Otherwise
440 /* The vcs_size might have changed while we slept to grab
441 * the user buffer, so recheck.
442 * Return data written up to now on failure.
444 size
= vcs_size(inode
);
453 if (this_round
> size
- pos
)
454 this_round
= size
- pos
;
456 /* OK, now actually push the write to the console
457 * under the lock using the local kernel buffer.
461 orig_count
= this_round
;
462 maxcol
= vc
->vc_cols
;
465 org0
= org
= screen_pos(vc
, p
, viewed
);
469 while (this_round
> 0) {
470 unsigned char c
= *con_buf0
++;
474 (vcs_scr_readw(vc
, org
) & 0xff00) | c
, org
);
476 if (++col
== maxcol
) {
477 org
= screen_pos(vc
, p
, viewed
);
483 if (p
< HEADER_SIZE
) {
484 char header
[HEADER_SIZE
];
486 getconsxy(vc
, header
+ 2);
487 while (p
< HEADER_SIZE
&& this_round
> 0) {
489 header
[p
++] = *con_buf0
++;
492 putconsxy(vc
, header
+ 2);
495 col
= (p
/2) % maxcol
;
496 if (this_round
> 0) {
497 org0
= org
= screen_pos(vc
, p
/2, viewed
);
498 if ((p
& 1) && this_round
> 0) {
504 vcs_scr_writew(vc
, c
|
505 (vcs_scr_readw(vc
, org
) & 0xff00), org
);
507 vcs_scr_writew(vc
, (c
<< 8) |
508 (vcs_scr_readw(vc
, org
) & 0xff), org
);
512 if (++col
== maxcol
) {
513 org
= screen_pos(vc
, p
/2, viewed
);
520 while (this_round
> 1) {
523 w
= get_unaligned(((unsigned short *)con_buf0
));
524 vcs_scr_writew(vc
, w
, org
++);
527 if (++col
== maxcol
) {
528 org
= screen_pos(vc
, p
, viewed
);
533 if (this_round
> 0) {
538 vcs_scr_writew(vc
, (vcs_scr_readw(vc
, org
) & 0xff) | (c
<< 8), org
);
540 vcs_scr_writew(vc
, (vcs_scr_readw(vc
, org
) & 0xff00) | c
, org
);
545 written
+= orig_count
;
549 update_region(vc
, (unsigned long)(org0
), org
- org0
);
558 free_page((unsigned long) con_buf
);
563 vcs_poll(struct file
*file
, poll_table
*wait
)
565 struct vcs_poll_data
*poll
= vcs_poll_data_get(file
);
566 __poll_t ret
= DEFAULT_POLLMASK
|EPOLLERR
|EPOLLPRI
;
569 poll_wait(file
, &poll
->waitq
, wait
);
570 if (poll
->seen_last_update
)
571 ret
= DEFAULT_POLLMASK
;
577 vcs_fasync(int fd
, struct file
*file
, int on
)
579 struct vcs_poll_data
*poll
= file
->private_data
;
582 /* don't allocate anything if all we want is disable fasync */
585 poll
= vcs_poll_data_get(file
);
590 return fasync_helper(fd
, file
, on
, &poll
->fasync
);
594 vcs_open(struct inode
*inode
, struct file
*filp
)
596 unsigned int currcons
= iminor(inode
) & 127;
600 if(currcons
&& !vc_cons_allocated(currcons
-1))
606 static int vcs_release(struct inode
*inode
, struct file
*file
)
608 struct vcs_poll_data
*poll
= file
->private_data
;
611 vcs_poll_data_free(poll
);
615 static const struct file_operations vcs_fops
= {
620 .fasync
= vcs_fasync
,
622 .release
= vcs_release
,
625 static struct class *vc_class
;
627 void vcs_make_sysfs(int index
)
629 device_create(vc_class
, NULL
, MKDEV(VCS_MAJOR
, index
+ 1), NULL
,
631 device_create(vc_class
, NULL
, MKDEV(VCS_MAJOR
, index
+ 129), NULL
,
632 "vcsa%u", index
+ 1);
635 void vcs_remove_sysfs(int index
)
637 device_destroy(vc_class
, MKDEV(VCS_MAJOR
, index
+ 1));
638 device_destroy(vc_class
, MKDEV(VCS_MAJOR
, index
+ 129));
641 int __init
vcs_init(void)
645 if (register_chrdev(VCS_MAJOR
, "vcs", &vcs_fops
))
646 panic("unable to get major %d for vcs device", VCS_MAJOR
);
647 vc_class
= class_create(THIS_MODULE
, "vc");
649 device_create(vc_class
, NULL
, MKDEV(VCS_MAJOR
, 0), NULL
, "vcs");
650 device_create(vc_class
, NULL
, MKDEV(VCS_MAJOR
, 128), NULL
, "vcsa");
651 for (i
= 0; i
< MIN_NR_CONSOLES
; i
++)