Subversion Repositories HelenOS-historic

Rev

Rev 623 | Go to most recent revision | Blame | Last modification | View Log | Download | RSS feed

  1. /*
  2.  * Copyright (C) 2001-2004 Jakub Jermar
  3.  * All rights reserved.
  4.  *
  5.  * Redistribution and use in source and binary forms, with or without
  6.  * modification, are permitted provided that the following conditions
  7.  * are met:
  8.  *
  9.  * - Redistributions of source code must retain the above copyright
  10.  *   notice, this list of conditions and the following disclaimer.
  11.  * - Redistributions in binary form must reproduce the above copyright
  12.  *   notice, this list of conditions and the following disclaimer in the
  13.  *   documentation and/or other materials provided with the distribution.
  14.  * - The name of the author may not be used to endorse or promote products
  15.  *   derived from this software without specific prior written permission.
  16.  *
  17.  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18.  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20.  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21.  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22.  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23.  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24.  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26.  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27.  */
  28.  
  29. #include <putchar.h>
  30. #include <print.h>
  31. #include <synch/spinlock.h>
  32. #include <arch/arg.h>
  33. #include <arch/asm.h>
  34.  
  35. #include <arch.h>
  36.  
  37. static char digits[] = "0123456789abcdef";  /**< Hexadecimal characters */
  38. SPINLOCK_INITIALIZE(printflock);        /**< printf spinlock */
  39.  
  40.  
  41. /** Print NULL terminated string
  42.  *
  43.  * Print characters from str using putchar() until
  44.  * \\0 character is reached.
  45.  *
  46.  * @param str Characters to print.
  47.  *
  48.  */
  49. static void print_str(const char *str)
  50. {
  51.     int i = 0;
  52.     char c;
  53.    
  54.     while ((c = str[i++]))
  55.         putchar(c);
  56. }
  57.  
  58.  
  59. /** Print hexadecimal digits
  60.  *
  61.  * Print fixed count of hexadecimal digits from
  62.  * the number num. The digits are printed in
  63.  * natural left-to-right order starting with
  64.  * the width-th digit.
  65.  *
  66.  * @param num   Number containing digits.
  67.  * @param width Count of digits to print.
  68.  *
  69.  */
  70. static void print_fixed_hex(const __u64 num, const int width)
  71. {
  72.     int i;
  73.    
  74.     for (i = width*8 - 4; i >= 0; i -= 4)
  75.         putchar(digits[(num>>i) & 0xf]);
  76. }
  77.  
  78.  
  79. /** Print number in given base
  80.  *
  81.  * Print significant digits of a number in given
  82.  * base.
  83.  *
  84.  * @param num  Number to print.
  85.  * @param base Base to print the number in (should
  86.  *             be in range 2 .. 16).
  87.  *
  88.  */
  89. static void print_number(const __native num, const unsigned int base)
  90. {
  91.     int val = num;
  92.     char d[sizeof(__native)*8+1];       /* this is good enough even for base == 2 */
  93.     int i = sizeof(__native)*8-1;
  94.    
  95.     do {
  96.         d[i--] = digits[val % base];
  97.     } while (val /= base);
  98.    
  99.     d[sizeof(__native)*8] = 0; 
  100.     print_str(&d[i + 1]);
  101. }
  102.  
  103.  
  104.  
  105. /** General formatted text print
  106.  *
  107.  * Print text formatted according the fmt parameter
  108.  * and variant arguments. Each formatting directive
  109.  * begins with \% (percentage) character and one of the
  110.  * following character:
  111.  *
  112.  * \%    Prints the percentage character.
  113.  *
  114.  * s    The next variant argument is treated as char*
  115.  *      and printed as a NULL terminated string.
  116.  *
  117.  * c    The next variant argument is treated as a single char.
  118.  *
  119.  * p    The next variant argument is treated as a maximum
  120.  *      bit-width integer with respect to architecture
  121.  *      and printed in full hexadecimal width.
  122.  *
  123.  * P    As with 'p', but '0x' is prefixed.
  124.  *
  125.  * q    The next variant argument is treated as a 64b integer
  126.  *      and printed in full hexadecimal width.
  127.  *
  128.  * Q    As with 'q', but '0x' is prefixed.
  129.  *
  130.  * l    The next variant argument is treated as a 32b integer
  131.  *      and printed in full hexadecimal width.
  132.  *
  133.  * L    As with 'l', but '0x' is prefixed.
  134.  *
  135.  * w    The next variant argument is treated as a 16b integer
  136.  *      and printed in full hexadecimal width.
  137.  *
  138.  * W    As with 'w', but '0x' is prefixed.
  139.  *
  140.  * b    The next variant argument is treated as a 8b integer
  141.  *      and printed in full hexadecimal width.
  142.  *
  143.  * B    As with 'b', but '0x' is prefixed.
  144.  *
  145.  * d    The next variant argument is treated as integer
  146.  *      and printed in standard decimal format (only significant
  147.  *      digits).
  148.  *
  149.  * x    The next variant argument is treated as integer
  150.  *      and printed in standard hexadecimal format (only significant
  151.  *      digits).
  152.  *
  153.  * X    As with 'x', but '0x' is prefixed.
  154.  *
  155.  * .    The decimal number following period will be treated as precision
  156.  *      for printing floating point numbers. One of 'e', 'E', 'f' or 'F'
  157.  *      must follow.
  158.  *
  159.  * All other characters from fmt except the formatting directives
  160.  * are printed in verbatim.
  161.  *
  162.  * @param fmt Formatting NULL terminated string.
  163.  */
  164. void printf(const char *fmt, ...)
  165. {
  166.     int irqpri, i = 0;
  167.     va_list ap;
  168.     char c;
  169.    
  170.     va_start(ap, fmt);
  171.  
  172.     irqpri = interrupts_disable();
  173.     spinlock_lock(&printflock);
  174.  
  175.     while ((c = fmt[i++])) {
  176.         switch (c) {
  177.  
  178.             /* control character */
  179.             case '%':
  180.            
  181.             switch (c = fmt[i++]) {
  182.  
  183.                 /* percentile itself */
  184.                 case '%':
  185.                 break;
  186.  
  187.                 /*
  188.                  * String and character conversions.
  189.                  */
  190.                 case 's':
  191.                 print_str(va_arg(ap, char_ptr));
  192.                 goto loop;
  193.  
  194.                 case 'c':
  195.                 c = (char) va_arg(ap, int);
  196.                 break;
  197.  
  198.                 /*
  199.                      * Hexadecimal conversions with fixed width.
  200.                      */
  201.                 case 'P':
  202.                 print_str("0x");
  203.                 case 'p':
  204.                     print_fixed_hex(va_arg(ap, __native), sizeof(__native));
  205.                 goto loop;
  206.  
  207.                 case 'Q':
  208.                 print_str("0x");
  209.                 case 'q':
  210.                     print_fixed_hex(va_arg(ap, __u64), INT64);
  211.                 goto loop;
  212.  
  213.                 case 'L':
  214.                 print_str("0x");
  215.                 case 'l':
  216.                     print_fixed_hex(va_arg(ap, __native), INT32);
  217.                 goto loop;
  218.  
  219.                 case 'W':
  220.                 print_str("0x");
  221.                 case 'w':
  222.                     print_fixed_hex(va_arg(ap, __native), INT16);
  223.                 goto loop;
  224.  
  225.                 case 'B':
  226.                 print_str("0x");
  227.                 case 'b':
  228.                     print_fixed_hex(va_arg(ap, __native), INT8);
  229.                 goto loop;
  230.    
  231.                 /*
  232.                      * Decimal and hexadecimal conversions.
  233.                      */
  234.                 case 'd':
  235.                     print_number(va_arg(ap, __native), 10);
  236.                 goto loop;
  237.  
  238.                 case 'X':
  239.                 print_str("0x");
  240.                 case 'x':
  241.                     print_number(va_arg(ap, __native), 16);
  242.                 goto loop;
  243.        
  244.                 /*
  245.                  * Bad formatting.
  246.                  */
  247.                 default:
  248.                 goto out;
  249.             }
  250.  
  251.             default: putchar(c);
  252.         }
  253.    
  254. loop:
  255.         ;
  256.     }
  257.  
  258. out:
  259.     spinlock_unlock(&printflock);
  260.     interrupts_restore(irqpri);
  261.    
  262.     va_end(ap);
  263. }
  264.