2 * Copyright (C) 2006 Michael Brown <mbrown@fensystems.co.uk>.
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License as
6 * published by the Free Software Foundation; either version 2 of the
7 * License, or any later version.
9 * This program is distributed in the hope that it will be useful, but
10 * WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
19 * You can also choose to distribute this program under the terms of
20 * the Unmodified Binary Distribution Licence (as given in the file
21 * COPYING.UBDL), provided that you have satisfied its requirements.
24 FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
28 #include <ipxe/ansiesc.h>
32 * ANSI escape sequences
37 * Call ANSI escape sequence handler
39 * @v ctx ANSI escape sequence context
40 * @v function Control function identifier
41 * @v count Parameter count
42 * @v params Parameter list
44 static void ansiesc_call_handler ( struct ansiesc_context *ctx,
45 unsigned int function, int count,
47 struct ansiesc_handler *handlers = ctx->handlers;
48 struct ansiesc_handler *handler;
50 for ( handler = handlers ; handler->function ; handler++ ) {
51 if ( handler->function == function ) {
52 handler->handle ( ctx, count, params );
59 * Process character that may be part of ANSI escape sequence
61 * @v ctx ANSI escape sequence context
63 * @ret c Original character if not part of escape sequence
64 * @ret <0 Character was part of escape sequence
66 * ANSI escape sequences will be plucked out of the character stream
67 * and interpreted; once complete they will be passed to the
68 * appropriate handler if one exists in this ANSI escape sequence
71 * In the interests of code size, we are rather liberal about the
72 * sequences we are prepared to accept as valid.
74 int ansiesc_process ( struct ansiesc_context *ctx, int c ) {
76 if ( ctx->count == 0 ) {
78 /* First byte of CSI : begin escape sequence */
80 memset ( ctx->params, 0xff, sizeof ( ctx->params ) );
84 /* Normal character */
89 /* Second byte of CSI : do nothing */
90 } else if ( ( c >= '0' ) && ( c <= '9' ) ) {
91 /* Parameter Byte : part of a parameter value */
92 int *param = &ctx->params[ctx->count - 1];
95 *param = ( ( *param * 10 ) + ( c - '0' ) );
96 } else if ( c == ';' ) {
97 /* Parameter Byte : parameter delimiter */
99 if ( ctx->count > ( sizeof ( ctx->params ) /
100 sizeof ( ctx->params[0] ) ) ) {
101 /* Excessive parameters : abort sequence */
103 DBG ( "Too many parameters in ANSI escape "
106 } else if ( ( ( c >= 0x20 ) && ( c <= 0x2f ) ) ||
108 /* Intermediate Byte */
112 /* Treat as Final Byte. Zero ctx->count before
113 * calling handler to avoid potential infinite loops.
115 int count = ctx->count;
119 ansiesc_call_handler ( ctx, ctx->function,
120 count, ctx->params );