1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause 3 * 4 * Copyright (c) 2009, 2013 The FreeBSD Foundation 5 * 6 * This software was developed by Ed Schouten under sponsorship from the 7 * FreeBSD Foundation. 8 * 9 * Portions of this software were developed by Oleksandr Rybalko 10 * under sponsorship from the FreeBSD Foundation. 11 * 12 * Redistribution and use in source and binary forms, with or without 13 * modification, are permitted provided that the following conditions 14 * are met: 15 * 1. Redistributions of source code must retain the above copyright 16 * notice, this list of conditions and the following disclaimer. 17 * 2. Redistributions in binary form must reproduce the above copyright 18 * notice, this list of conditions and the following disclaimer in the 19 * documentation and/or other materials provided with the distribution. 20 * 21 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31 * SUCH DAMAGE. 32 */ 33 34 #ifndef _DEV_VT_VT_H_ 35 #define _DEV_VT_VT_H_ 36 37 #include <sys/param.h> 38 #include <sys/_lock.h> 39 #include <sys/_mutex.h> 40 #include <sys/callout.h> 41 #include <sys/condvar.h> 42 #include <sys/conf.h> 43 #include <sys/consio.h> 44 #include <sys/kbio.h> 45 #include <sys/mouse.h> 46 #include <sys/terminal.h> 47 #include <sys/sysctl.h> 48 #include <sys/font.h> 49 #include <sys/taskqueue.h> 50 51 #include "opt_syscons.h" 52 #include "opt_splash.h" 53 54 #ifndef VT_MAXWINDOWS 55 #ifdef MAXCONS 56 #define VT_MAXWINDOWS MAXCONS 57 #else 58 #define VT_MAXWINDOWS 12 59 #endif 60 #endif 61 62 #ifndef VT_ALT_TO_ESC_HACK 63 #define VT_ALT_TO_ESC_HACK 1 64 #endif 65 66 #define VT_CONSWINDOW 0 67 68 #if defined(SC_TWOBUTTON_MOUSE) || defined(VT_TWOBUTTON_MOUSE) 69 #define VT_MOUSE_PASTEBUTTON MOUSE_BUTTON3DOWN /* right button */ 70 #define VT_MOUSE_EXTENDBUTTON MOUSE_BUTTON2DOWN /* not really used */ 71 #else 72 #define VT_MOUSE_PASTEBUTTON MOUSE_BUTTON2DOWN /* middle button */ 73 #define VT_MOUSE_EXTENDBUTTON MOUSE_BUTTON3DOWN /* right button */ 74 #endif /* defined(SC_TWOBUTTON_MOUSE) || defined(VT_TWOBUTTON_MOUSE) */ 75 76 #define SC_DRIVER_NAME "vt" 77 #ifdef VT_DEBUG 78 #define DPRINTF(_l, ...) if (vt_debug > (_l)) printf( __VA_ARGS__ ) 79 #define VT_CONSOLECTL_DEBUG 80 #define VT_SYSMOUSE_DEBUG 81 #else 82 #define DPRINTF(_l, ...) do {} while (0) 83 #endif 84 85 #define VT_SYSCTL_INT(_name, _default, _descr) \ 86 int vt_##_name = (_default); \ 87 SYSCTL_INT(_kern_vt, OID_AUTO, _name, CTLFLAG_RWTUN, &vt_##_name, 0, _descr) 88 89 struct vt_driver; 90 91 int vt_allocate(const struct vt_driver *, void *); 92 int vt_deallocate(const struct vt_driver *, void *); 93 94 typedef unsigned int vt_axis_t; 95 96 /* 97 * List of locks 98 * (d) locked by vd_lock 99 * (b) locked by vb_lock 100 * (G) locked by Giant 101 * (u) unlocked, locked by higher levels 102 * (c) const until freeing 103 * (?) yet to be determined 104 */ 105 106 /* 107 * Per-device datastructure. 108 */ 109 110 #ifndef SC_NO_CUTPASTE 111 struct vt_mouse_cursor; 112 #endif 113 114 struct vt_pastebuf { 115 term_char_t *vpb_buf; /* Copy-paste buffer. */ 116 unsigned int vpb_bufsz; /* Buffer size. */ 117 unsigned int vpb_len; /* Length of a last selection. */ 118 }; 119 120 struct vt_device { 121 struct vt_window *vd_windows[VT_MAXWINDOWS]; /* (c) Windows. */ 122 struct vt_window *vd_curwindow; /* (d) Current window. */ 123 struct vt_window *vd_savedwindow;/* (?) Saved for suspend. */ 124 struct vt_window *vd_grabwindow; /* (?) Saved before cngrab. */ 125 struct vt_pastebuf vd_pastebuf; /* (?) Copy/paste buf. */ 126 const struct vt_driver *vd_driver; /* (c) Graphics driver. */ 127 void *vd_softc; /* (u) Driver data. */ 128 const struct vt_driver *vd_prev_driver;/* (?) Previous driver. */ 129 void *vd_prev_softc; /* (?) Previous driver data. */ 130 device_t vd_video_dev; /* (?) Video adapter. */ 131 #ifndef SC_NO_CUTPASTE 132 struct vt_mouse_cursor *vd_mcursor; /* (?) Cursor bitmap. */ 133 term_color_t vd_mcursor_fg; /* (?) Cursor fg color. */ 134 term_color_t vd_mcursor_bg; /* (?) Cursor bg color. */ 135 vt_axis_t vd_mx_drawn; /* (?) Mouse X and Y */ 136 vt_axis_t vd_my_drawn; /* as of last redraw. */ 137 int vd_mshown; /* (?) Mouse shown during */ 138 #endif /* last redrawn. */ 139 uint16_t vd_mx; /* (?) Current mouse X. */ 140 uint16_t vd_my; /* (?) current mouse Y. */ 141 uint32_t vd_mstate; /* (?) Mouse state. */ 142 vt_axis_t vd_width; /* (?) Screen width. */ 143 vt_axis_t vd_height; /* (?) Screen height. */ 144 size_t vd_transpose; /* (?) Screen offset in FB */ 145 struct mtx vd_lock; /* Per-device lock. */ 146 struct cv vd_winswitch; /* (d) Window switch notify. */ 147 struct callout vd_timer; /* (d) Display timer. */ 148 volatile unsigned int vd_timer_armed;/* (?) Display timer started.*/ 149 int vd_flags; /* (d) Device flags. */ 150 #define VDF_TEXTMODE 0x01 /* Do text mode rendering. */ 151 #define VDF_SPLASH 0x02 /* Splash screen active. */ 152 #define VDF_ASYNC 0x04 /* vt_timer() running. */ 153 #define VDF_INVALID 0x08 /* Entire screen should be re-rendered. */ 154 #define VDF_DEAD 0x10 /* Early probing found nothing. */ 155 #define VDF_INITIALIZED 0x20 /* vtterm_cnprobe already done. */ 156 #define VDF_MOUSECURSOR 0x40 /* Mouse cursor visible. */ 157 #define VDF_QUIET_BELL 0x80 /* Disable bell. */ 158 #define VDF_SUSPENDED 0x100 /* Device has been suspended. */ 159 #define VDF_DOWNGRADE 0x8000 /* The driver is being downgraded. */ 160 struct keyboard *vd_keyboard; /* (G) Keyboard. */ 161 unsigned int vd_kbstate; /* (?) Device unit. */ 162 unsigned int vd_unit; /* (c) Device unit. */ 163 int vd_altbrk; /* (?) Alt break seq. state */ 164 term_char_t *vd_drawn; /* (?) Most recent char drawn. */ 165 term_color_t *vd_drawnfg; /* (?) Most recent fg color drawn. */ 166 term_color_t *vd_drawnbg; /* (?) Most recent bg color drawn. */ 167 168 struct mtx vd_flush_lock; /* (?) vt_flush() lock. */ 169 bool *vd_pos_to_flush;/* (?) Positions to flush. */ 170 }; 171 172 #define VD_PASTEBUF(vd) ((vd)->vd_pastebuf.vpb_buf) 173 #define VD_PASTEBUFSZ(vd) ((vd)->vd_pastebuf.vpb_bufsz) 174 #define VD_PASTEBUFLEN(vd) ((vd)->vd_pastebuf.vpb_len) 175 176 #define VT_LOCK(vd) mtx_lock(&(vd)->vd_lock) 177 #define VT_UNLOCK(vd) mtx_unlock(&(vd)->vd_lock) 178 #define VT_LOCK_ASSERT(vd, what) mtx_assert(&(vd)->vd_lock, what) 179 180 #define VT_FLUSH_LOCK(vd) \ 181 if ((vd)->vd_driver->vd_bitblt_after_vtbuf_unlock) \ 182 mtx_lock(&(vd)->vd_flush_lock) 183 184 #define VT_FLUSH_UNLOCK(vd) \ 185 if ((vd)->vd_driver->vd_bitblt_after_vtbuf_unlock) \ 186 mtx_unlock(&(vd)->vd_flush_lock) 187 188 void vt_resume(struct vt_device *vd); 189 void vt_resume_flush_timer(struct vt_window *vw, int ms); 190 void vt_suspend(struct vt_device *vd); 191 192 /* 193 * Per-window terminal screen buffer. 194 * 195 * Because redrawing is performed asynchronously, the buffer keeps track 196 * of a rectangle that needs to be redrawn (vb_dirtyrect). Because this 197 * approach seemed to cause suboptimal performance (when the top left 198 * and the bottom right of the screen are modified), it also uses a set 199 * of bitmasks to keep track of the rows and columns (mod 64) that have 200 * been modified. 201 */ 202 203 struct vt_buf { 204 struct mtx vb_lock; /* Buffer lock. */ 205 struct terminal *vb_terminal; 206 term_pos_t vb_scr_size; /* (b) Screen dimensions. */ 207 int vb_flags; /* (b) Flags. */ 208 #define VBF_CURSOR 0x1 /* Cursor visible. */ 209 #define VBF_STATIC 0x2 /* Buffer is statically allocated. */ 210 #define VBF_MTX_INIT 0x4 /* Mutex initialized. */ 211 #define VBF_SCROLL 0x8 /* scroll locked mode. */ 212 #define VBF_HISTORY_FULL 0x10 /* All rows filled. */ 213 unsigned int vb_history_size; 214 unsigned int vb_roffset; /* (b) History rows offset. */ 215 unsigned int vb_curroffset; /* (b) Saved rows offset. */ 216 term_pos_t vb_cursor; /* (u) Cursor position. */ 217 term_pos_t vb_mark_start; /* (b) Copy region start. */ 218 term_pos_t vb_mark_end; /* (b) Copy region end. */ 219 int vb_mark_last; /* Last mouse event. */ 220 term_rect_t vb_dirtyrect; /* (b) Dirty rectangle. */ 221 term_char_t *vb_buffer; /* (u) Data buffer. */ 222 term_char_t **vb_rows; /* (u) Array of rows */ 223 }; 224 225 #ifdef SC_HISTORY_SIZE 226 #define VBF_DEFAULT_HISTORY_SIZE SC_HISTORY_SIZE 227 #else 228 #define VBF_DEFAULT_HISTORY_SIZE 500 229 #endif 230 231 void vtbuf_lock(struct vt_buf *); 232 void vtbuf_unlock(struct vt_buf *); 233 void vtbuf_copy(struct vt_buf *, const term_rect_t *, const term_pos_t *); 234 void vtbuf_fill(struct vt_buf *, const term_rect_t *, term_char_t); 235 void vtbuf_init_early(struct vt_buf *); 236 void vtbuf_init(struct vt_buf *, const term_pos_t *); 237 void vtbuf_grow(struct vt_buf *, const term_pos_t *, unsigned int); 238 void vtbuf_putchar(struct vt_buf *, const term_pos_t *, term_char_t); 239 void vtbuf_cursor_position(struct vt_buf *, const term_pos_t *); 240 void vtbuf_scroll_mode(struct vt_buf *vb, int yes); 241 void vtbuf_dirty(struct vt_buf *vb, const term_rect_t *area); 242 void vtbuf_undirty(struct vt_buf *, term_rect_t *); 243 void vtbuf_sethistory_size(struct vt_buf *, unsigned int); 244 void vtbuf_clearhistory(struct vt_buf *); 245 int vtbuf_iscursor(const struct vt_buf *vb, int row, int col); 246 void vtbuf_cursor_visibility(struct vt_buf *, int); 247 #ifndef SC_NO_CUTPASTE 248 int vtbuf_set_mark(struct vt_buf *vb, int type, int col, int row); 249 int vtbuf_get_marked_len(struct vt_buf *vb); 250 void vtbuf_extract_marked(struct vt_buf *vb, term_char_t *buf, int sz, int mark); 251 void vtbuf_unmark(struct vt_buf *vb); 252 void vtbuf_unmark_on_cross(struct vt_buf *vb, int target_begin, int target_end); 253 #endif 254 255 #define VTB_MARK_NONE 0 256 #define VTB_MARK_END 1 257 #define VTB_MARK_START 2 258 #define VTB_MARK_WORD 3 259 #define VTB_MARK_ROW 4 260 #define VTB_MARK_EXTEND 5 261 #define VTB_MARK_MOVE 6 262 263 #define VTBUF_SLCK_ENABLE(vb) vtbuf_scroll_mode((vb), 1) 264 #define VTBUF_SLCK_DISABLE(vb) vtbuf_scroll_mode((vb), 0) 265 266 #define VTBUF_MAX_HEIGHT(vb) \ 267 ((vb)->vb_history_size) 268 #define VTBUF_GET_ROW(vb, r) \ 269 ((vb)->vb_rows[((vb)->vb_roffset + (r)) % VTBUF_MAX_HEIGHT(vb)]) 270 #define VTBUF_GET_FIELD(vb, r, c) \ 271 ((vb)->vb_rows[((vb)->vb_roffset + (r)) % VTBUF_MAX_HEIGHT(vb)][(c)]) 272 #define VTBUF_FIELD(vb, r, c) \ 273 ((vb)->vb_rows[((vb)->vb_curroffset + (r)) % VTBUF_MAX_HEIGHT(vb)][(c)]) 274 #define VTBUF_ISCURSOR(vb, r, c) \ 275 vtbuf_iscursor((vb), (r), (c)) 276 #define VTBUF_DIRTYROW(mask, row) \ 277 ((mask)->vbm_row & ((uint64_t)1 << ((row) % 64))) 278 #define VTBUF_DIRTYCOL(mask, col) \ 279 ((mask)->vbm_col & ((uint64_t)1 << ((col) % 64))) 280 #define VTBUF_SPACE_CHAR(attr) (' ' | (attr)) 281 282 #define VHS_SET 0 283 #define VHS_CUR 1 284 #define VHS_END 2 285 int vthistory_seek(struct vt_buf *, int offset, int whence); 286 void vthistory_addlines(struct vt_buf *vb, int offset); 287 void vthistory_getpos(const struct vt_buf *, unsigned int *offset); 288 289 /* 290 * Per-window datastructure. 291 */ 292 293 struct vt_window { 294 struct vt_device *vw_device; /* (c) Device. */ 295 struct terminal *vw_terminal; /* (c) Terminal. */ 296 struct vt_buf vw_buf; /* (u) Screen buffer. */ 297 struct vt_font *vw_font; /* (d) Graphical font. */ 298 term_rect_t vw_draw_area; /* (?) Drawable area. */ 299 unsigned int vw_number; /* (c) Window number. */ 300 int vw_kbdmode; /* (?) Keyboard mode. */ 301 int vw_prev_kbdmode;/* (?) Previous mode. */ 302 int vw_kbdstate; /* (?) Keyboard state. */ 303 int vw_grabbed; /* (?) Grab count. */ 304 char *vw_kbdsq; /* Escape sequence queue*/ 305 unsigned int vw_flags; /* (d) Per-window flags. */ 306 int vw_mouse_level;/* Mouse op mode. */ 307 #define VWF_BUSY 0x1 /* Busy reconfiguring device. */ 308 #define VWF_OPENED 0x2 /* TTY in use. */ 309 #define VWF_SCROLL 0x4 /* Keys influence scrollback. */ 310 #define VWF_CONSOLE 0x8 /* Kernel message console window. */ 311 #define VWF_VTYLOCK 0x10 /* Prevent window switch. */ 312 #define VWF_MOUSE_HIDE 0x20 /* Disable mouse events processing. */ 313 #define VWF_READY 0x40 /* Window fully initialized. */ 314 #define VWF_GRAPHICS 0x80 /* Window in graphics mode (KDSETMODE). */ 315 #define VWF_SWWAIT_REL 0x10000 /* Program wait for VT acquire is done. */ 316 #define VWF_SWWAIT_ACQ 0x20000 /* Program wait for VT release is done. */ 317 pid_t vw_pid; /* Terminal holding process */ 318 struct proc *vw_proc; 319 struct vt_mode vw_smode; /* switch mode */ 320 struct timeout_task vw_timeout_task_dead; 321 struct vt_window *vw_switch_to; 322 int vw_bell_pitch; /* (?) Bell pitch */ 323 sbintime_t vw_bell_duration; /* (?) Bell duration */ 324 }; 325 326 #define VT_AUTO 0 /* switching is automatic */ 327 #define VT_PROCESS 1 /* switching controlled by prog */ 328 #define VT_KERNEL 255 /* switching controlled in kernel */ 329 330 #define IS_VT_PROC_MODE(vw) ((vw)->vw_smode.mode == VT_PROCESS) 331 332 /* 333 * Per-device driver routines. 334 */ 335 336 typedef int vd_init_t(struct vt_device *vd); 337 typedef int vd_probe_t(struct vt_device *vd); 338 typedef void vd_fini_t(struct vt_device *vd, void *softc); 339 typedef void vd_postswitch_t(struct vt_device *vd); 340 typedef void vd_blank_t(struct vt_device *vd, term_color_t color); 341 typedef void vd_bitblt_text_t(struct vt_device *vd, const struct vt_window *vw, 342 const term_rect_t *area); 343 typedef void vd_invalidate_text_t(struct vt_device *vd, 344 const term_rect_t *area); 345 typedef void vd_bitblt_bmp_t(struct vt_device *vd, const struct vt_window *vw, 346 const uint8_t *pattern, const uint8_t *mask, 347 unsigned int width, unsigned int height, 348 unsigned int x, unsigned int y, term_color_t fg, term_color_t bg); 349 typedef int vd_bitblt_argb_t(struct vt_device *vd, const struct vt_window *vw, 350 const uint8_t *argb, 351 unsigned int width, unsigned int height, 352 unsigned int x, unsigned int y); 353 typedef int vd_fb_ioctl_t(struct vt_device *, u_long, caddr_t, struct thread *); 354 typedef int vd_fb_mmap_t(struct vt_device *, vm_ooffset_t, vm_paddr_t *, int, 355 vm_memattr_t *); 356 typedef void vd_drawrect_t(struct vt_device *, int, int, int, int, int, 357 term_color_t); 358 typedef void vd_setpixel_t(struct vt_device *, int, int, term_color_t); 359 typedef void vd_suspend_t(struct vt_device *); 360 typedef void vd_resume_t(struct vt_device *); 361 362 struct vt_driver { 363 char vd_name[16]; 364 /* Console attachment. */ 365 vd_probe_t *vd_probe; 366 vd_init_t *vd_init; 367 vd_fini_t *vd_fini; 368 369 /* Drawing. */ 370 vd_blank_t *vd_blank; 371 vd_drawrect_t *vd_drawrect; 372 vd_setpixel_t *vd_setpixel; 373 vd_bitblt_text_t *vd_bitblt_text; 374 vd_invalidate_text_t *vd_invalidate_text; 375 vd_bitblt_bmp_t *vd_bitblt_bmp; 376 vd_bitblt_argb_t *vd_bitblt_argb; 377 378 /* Framebuffer ioctls, if present. */ 379 vd_fb_ioctl_t *vd_fb_ioctl; 380 381 /* Framebuffer mmap, if present. */ 382 vd_fb_mmap_t *vd_fb_mmap; 383 384 /* Update display setting on vt switch. */ 385 vd_postswitch_t *vd_postswitch; 386 387 /* Suspend/resume handlers. */ 388 vd_suspend_t *vd_suspend; 389 vd_resume_t *vd_resume; 390 391 /* Priority to know which one can override */ 392 int vd_priority; 393 #define VD_PRIORITY_DUMB 10 394 #define VD_PRIORITY_GENERIC 100 395 #define VD_PRIORITY_SPECIFIC 1000 396 397 /* 398 * Should vd_bitblt_text() be called after unlocking vtbuf? If true, 399 * characters are copied before vd_bitblt_bmp() is called. 400 * 401 * This is only valid when the default bitblt_text callback is used. 402 */ 403 bool vd_bitblt_after_vtbuf_unlock; 404 }; 405 406 /* 407 * Console device madness. 408 * 409 * Utility macro to make early vt(4) instances work. 410 */ 411 412 extern struct vt_device vt_consdev; 413 void vt_upgrade(struct vt_device *vd); 414 415 #define PIXEL_WIDTH(w) ((w) / 8) 416 #define PIXEL_HEIGHT(h) ((h) / 16) 417 418 #ifndef VT_FB_MAX_WIDTH 419 #define VT_FB_MAX_WIDTH 4096 420 #endif 421 #ifndef VT_FB_MAX_HEIGHT 422 #define VT_FB_MAX_HEIGHT 2400 423 #endif 424 425 /* name argument is not used yet. */ 426 #define VT_DRIVER_DECLARE(name, drv) DATA_SET(vt_drv_set, drv) 427 428 #ifndef SC_NO_CUTPASTE 429 struct vt_mouse_cursor { 430 uint8_t map[64 * 64 / 8]; 431 uint8_t mask[64 * 64 / 8]; 432 uint8_t width; 433 uint8_t height; 434 }; 435 #endif 436 437 const uint8_t *vtfont_lookup(const struct vt_font *vf, term_char_t c); 438 struct vt_font *vtfont_ref(struct vt_font *vf); 439 void vtfont_unref(struct vt_font *vf); 440 int vtfont_load(vfnt_t *f, struct vt_font **ret); 441 442 /* Sysmouse. */ 443 void sysmouse_process_event(mouse_info_t *mi); 444 #ifndef SC_NO_CUTPASTE 445 void vt_mouse_event(int type, int x, int y, int event, int cnt, int mlevel); 446 void vt_mouse_state(int show); 447 #endif 448 #define VT_MOUSE_SHOW 1 449 #define VT_MOUSE_HIDE 0 450 451 /* Utilities. */ 452 void vt_compute_drawable_area(struct vt_window *); 453 void vt_determine_colors(term_char_t c, int cursor, 454 term_color_t *fg, term_color_t *bg); 455 int vt_is_cursor_in_area(const struct vt_device *vd, 456 const term_rect_t *area); 457 void vt_termsize(struct vt_device *, struct vt_font *, term_pos_t *); 458 void vt_winsize(struct vt_device *, struct vt_font *, struct winsize *); 459 460 /* Logos-on-boot. */ 461 #define VT_LOGOS_DRAW_BEASTIE 0 462 #define VT_LOGOS_DRAW_ALT_BEASTIE 1 463 #define VT_LOGOS_DRAW_ORB 2 464 465 extern int vt_draw_logo_cpus; 466 extern int vt_splash_cpu; 467 extern int vt_splash_ncpu; 468 extern int vt_splash_cpu_style; 469 extern int vt_splash_cpu_duration; 470 471 extern const unsigned int vt_logo_sprite_height; 472 extern const unsigned int vt_logo_sprite_width; 473 474 void vtterm_draw_cpu_logos(struct vt_device *); 475 476 #endif /* !_DEV_VT_VT_H_ */ 477