Diff markup

Differences between /hwcore/idt.h (Article 3) and /hwcore/idt.h (Article 2)

 /* Copyright (C) 2004  David Decotigny             /* Copyright (C) 2004  David Decotigny
    Copyright (C) 1999  Free Software Foundatio        Copyright (C) 1999  Free Software Foundation, Inc.
                                                    
    This program is free software; you can redi        This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU Genera        modify it under the terms of the GNU General Public License
    as published by the Free Software Foundatio        as published by the Free Software Foundation; either version 2
    of the License, or (at your option) any lat        of the License, or (at your option) any later version.
                                                       
    This program is distributed in the hope tha        This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the         but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details        GNU General Public License for more details.
                                                       
    You should have received a copy of the GNU         You should have received a copy of the GNU General Public License
    along with this program; if not, write to t        along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place - Suite 3        Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
    USA.                                               USA. 
 */                                                 */
 #ifndef _SOS_IDT_H_                                #ifndef _SOS_IDT_H_
 #define _SOS_IDT_H_                                #define _SOS_IDT_H_
                                                    
 /**                                                /**
  * @file idt.h                                      * @file idt.h
  *                                                  *
  * Manage the x86 Interrupt Descriptor Table,       * Manage the x86 Interrupt Descriptor Table, the table which maps the
  * hardware interrupt lines, hardware exceptio      * hardware interrupt lines, hardware exceptions, and software
  * interrupts, to software routines. We only d      * interrupts, to software routines. We only define "interrupt gate"
  * IDT entries. Don't use it directly; refer i      * IDT entries. Don't use it directly; refer instead to interrupt.c,
  * exceptions.c and syscall.c.                      * exceptions.c and syscall.c.
  *                                                  *
  * @see Intel x86 doc, Vol 3, chapter 5             * @see Intel x86 doc, Vol 3, chapter 5
  */                                                 */
                                                    
 #include <sos/errno.h>                             #include <sos/errno.h>
 #include <sos/types.h>                             #include <sos/types.h>
                                                    
 /* Mapping of the CPU exceptions in the IDT (i     /* Mapping of the CPU exceptions in the IDT (imposed by Intel
    standards) */                                      standards) */
 #define SOS_EXCEPT_BASE 0                          #define SOS_EXCEPT_BASE 0
 #define SOS_EXCEPT_NUM  32                         #define SOS_EXCEPT_NUM  32
 #define SOS_EXCEPT_MAX  (SOS_HWEXCEPT_BASE + S     #define SOS_EXCEPT_MAX  (SOS_HWEXCEPT_BASE + SOS_HWEXCEPT_NUM - 1)
                                                    
 /* Mapping of the IRQ lines in the IDT */          /* Mapping of the IRQ lines in the IDT */
 #define SOS_IRQ_BASE    32                         #define SOS_IRQ_BASE    32
 #define SOS_IRQ_NUM     16                         #define SOS_IRQ_NUM     16
 #define SOS_IRQ_MAX     (SOS_IRQ_BASE + SOS_IR     #define SOS_IRQ_MAX     (SOS_IRQ_BASE + SOS_IRQ_NUM - 1)
                                                    
 /**                                                /**
  * Number of IDT entries.                           * Number of IDT entries.
  *                                                  *
  * @note Must be large enough to map the hw in      * @note Must be large enough to map the hw interrupts, the exceptions
  * (=> total is 48 entries), and the syscall(s      * (=> total is 48 entries), and the syscall(s). Since our syscall
  * will be 0x42, it must be >= 0x43. Intel doc      * will be 0x42, it must be >= 0x43. Intel doc limits this to 256
  * entries, we use this limit.                      * entries, we use this limit.
  */                                                 */
 #define SOS_IDTE_NUM      256 /* 0x100 */          #define SOS_IDTE_NUM      256 /* 0x100 */
                                                    
 /** Initialization routine: all the IDT entrie     /** Initialization routine: all the IDT entries (or "IDTE") are marked
     "not present". */                                  "not present". */
 sos_ret_t sos_idt_setup(void);                     sos_ret_t sos_idt_setup(void);
                                                    
 /**                                                /**
  * Enable the IDT entry if handler_address !=       * Enable the IDT entry if handler_address != NULL, with the given
  * lowest_priviledge.\ Disable the IDT entry w      * lowest_priviledge.\ Disable the IDT entry when handler_address ==
  * NULL (the lowest_priviledge parameter is th      * NULL (the lowest_priviledge parameter is then ignored). Intel doc
  * says that there must not be more than 256 e      * says that there must not be more than 256 entries.
  *                                                  *
  * @note IRQ Unsafe                                 * @note IRQ Unsafe
  */                                                 */
 sos_ret_t sos_idt_set_handler(int index,           sos_ret_t sos_idt_set_handler(int index,
                               sos_vaddr_t hand                                   sos_vaddr_t handler_address,
                               int lowest_privi                                   int lowest_priviledge /* 0..3 */);
                                                    
                                                    
 /**                                                /**
  * @note IRQ Unsafe                                 * @note IRQ Unsafe
  *                                                  *
  * @return the handler address and DPL in the       * @return the handler address and DPL in the 2nd and 3rd
  * parameters                                       * parameters
  */                                                 */
 sos_ret_t sos_idt_get_handler(int index,           sos_ret_t sos_idt_get_handler(int index,
                               sos_vaddr_t *han                                   sos_vaddr_t *handler_address,
                               int *lowest_priv                                   int *lowest_priviledge);
                                                    
 #endif /* _SOS_IDT_H_ */                           #endif /* _SOS_IDT_H_ */