summaryrefslogtreecommitdiffstats
path: root/c/src/exec/posix/include/rtems/posix/intr.h
blob: 26abb92074971224613b05260ff9b02f7f98f553 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
/*  rtems/posix/intr.h
 *
 *  This include file contains all the private support information for
 *  POSIX Interrupt Manager.
 *
 *  COPYRIGHT (c) 1989-1997.
 *  On-Line Applications Research Corporation (OAR).
 *  Copyright assigned to U.S. Government, 1994.
 *
 *  The license and distribution terms for this file may be
 *  found in the file LICENSE in this distribution or at
 *  http://www.OARcorp.com/rtems/license.html.
 *
 *  $Id$
 */
 
#ifndef __RTEMS_POSIX_KEY_h
#define __RTEMS_POSIX_KEY_h
 
#ifdef __cplusplus
extern "C" {
#endif

#include <rtems/score/isr.h>
#include <rtems/score/object.h>

/*
 *  Data Structure used to manage each POSIX Interrupt Vector
 */

typedef struct {
  int            number_installed;
  int            lock_count;
  int            deferred_count;
  Chain_Control  Handlers;
} POSIX_Interrupt_Control;
 
/*
 *  Data Structure used to manage a POSIX Interrupt Handler
 */
 
typedef struct {
  Objects_Control         Object;
  int                     is_active; 
  intr_t                  vector; 
  Thread_Control         *server;
  int                   (*handler)( void *area );
  volatile void           *user_data_area;
}  POSIX_Interrupt_Handler_control;

/*
 *  The following defines the information control block used to manage
 *  this class of objects.
 */
 
POSIX_EXTERN Objects_Information _POSIX_Interrupt_Handlers_Information;

/*
 *  The following is an array which is used to manage the set of
 *  interrupt handlers installed on each vector.
 */

POSIX_EXTERN POSIX_Interrupt_Control 
               _POSIX_Interrupt_Information[ ISR_NUMBER_OF_VECTORS ];
 
/*
 *  _POSIX_Interrupt_Manager_initialization
 *
 *  DESCRIPTION:
 *
 *  This routine performs the initialization necessary for this manager.
 */
 
void _POSIX_Interrupt_Manager_initialization( 
  unsigned32  maximum_interrupt_handlers
);
 
/*
 *  _POSIX_Interrupt_Allocate
 *
 *  DESCRIPTION:
 *
 *  This function allocates a interrupt handler control block from
 *  the inactive chain of free interrupt handler control blocks.
 */
 
RTEMS_INLINE_ROUTINE POSIX_Interrupt_Handler_control *
  _POSIX_Interrupt_Allocate( void );
 
/*
 *  _POSIX_Interrupt_Free
 *
 *  DESCRIPTION:
 *
 *  This routine frees a interrupt handler control block to the
 *  inactive chain of free interrupt handler control blocks.
 */
 
RTEMS_INLINE_ROUTINE void _POSIX_Interrupt_Free (
  POSIX_Interrupt_Handler_control *the_intr
);
 
/*
 *  _POSIX_Interrupt_Get
 *
 *  DESCRIPTION:
 *
 *  This function maps interrupt handler IDs to interrupt handler control 
 *  blocks.  If ID corresponds to a local interrupt handler, then it returns
 *  the_intr control pointer which maps to ID and location
 *  is set to OBJECTS_LOCAL.  if the interrupt handler ID is global and
 *  resides on a remote node, then location is set to OBJECTS_REMOTE,
 *  and the_intr is undefined.  Otherwise, location is set
 *  to OBJECTS_ERROR and the_intr is undefined.
 */
 
RTEMS_INLINE_ROUTINE POSIX_Interrupt_Control *_POSIX_Interrupt_Get (
  Objects_Id         id,
  Objects_Locations *location
);
 
/*
 *  _POSIX_Interrupt_Is_null
 *
 *  DESCRIPTION:
 *
 *  This function returns TRUE if the_intr is NULL and FALSE otherwise.
 */
 
RTEMS_INLINE_ROUTINE boolean _POSIX_Interrupt_Is_null (
  POSIX_Interrupt_Handler_control *the_intr
);
 
/*
 *  _POSIX_Interrupt_Handler
 *
 *  DESCRIPTION:
 *
 *  This function XXX.
 */
 
void _POSIX_Interrupt_Handler(
  ISR_Vector_number   vector
);

#include <rtems/posix/intr.inl>

#ifdef __cplusplus
}
#endif
 
#endif
/*  end of include file */