source: mainline/kernel/generic/include/ipc/irq.h@ 5a5269d

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 5a5269d was 5a5269d, checked in by GitHub <noreply@…>, 6 years ago

Change type of uspace pointers in kernel from pointer type to numeric (#170)

From kernel's perspective, userspace addresses are not valid pointers,
and can only be used in calls to copy_to/from_uspace().
Therefore, we change the type of those arguments and variables to
uspace_addr_t which is an alias for sysarg_t.

This allows the compiler to catch accidental direct accesses to
userspace addresses.

Additionally, to avoid losing the type information in code,
a macro uspace_ptr(type) is used that translates to uspace_addr_t.
I makes no functional difference, but allows keeping the type information
in code in case we implement some sort of static checking for it in the future.

However, ccheck doesn't like that, so instead of using uspace_ptr(char),
we use uspace_ptr_char which is defined as
#define uspace_ptr_char uspace_ptr(char).

  • Property mode set to 100644
File size: 2.9 KB
Line 
1/*
2 * Copyright (c) 2006 Ondrej Palkovsky
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/** @addtogroup kernel_generic_ipc
30 * @{
31 */
32/** @file
33 */
34
35#ifndef KERN_IPC_IRQ_H_
36#define KERN_IPC_IRQ_H_
37
38/** Maximum number of IPC IRQ programmed I/O ranges. */
39#define IRQ_MAX_RANGE_COUNT 8
40
41/** Maximum length of IPC IRQ program. */
42#define IRQ_MAX_PROG_SIZE 256
43
44#include <ipc/ipc.h>
45#include <ddi/irq.h>
46#include <typedefs.h>
47#include <adt/list.h>
48
49extern irq_ownership_t ipc_irq_top_half_claim(irq_t *);
50extern void ipc_irq_top_half_handler(irq_t *);
51
52extern errno_t ipc_irq_subscribe(answerbox_t *, inr_t, sysarg_t, uspace_ptr_irq_code_t,
53 uspace_ptr_cap_irq_handle_t);
54extern errno_t ipc_irq_unsubscribe(answerbox_t *, cap_irq_handle_t);
55
56/*
57 * User friendly wrappers for ipc_irq_send_msg(). They are in the form
58 * ipc_irq_send_msg_m(), where m is the number of payload arguments.
59 */
60#define ipc_irq_send_msg_0(irq) \
61 ipc_irq_send_msg((irq), 0, 0, 0, 0, 0)
62
63#define ipc_irq_send_msg_1(irq, a1) \
64 ipc_irq_send_msg((irq), (a1), 0, 0, 0, 0)
65
66#define ipc_irq_send_msg_2(irq, a1, a2) \
67 ipc_irq_send_msg((irq), (a1), (a2), 0, 0, 0)
68
69#define ipc_irq_send_msg_3(irq, a1, a2, a3) \
70 ipc_irq_send_msg((irq), (a1), (a2), (a3), 0, 0)
71
72#define ipc_irq_send_msg_4(irq, a1, a2, a3, a4) \
73 ipc_irq_send_msg((irq), (a1), (a2), (a3), (a4), 0)
74
75#define ipc_irq_send_msg_5(irq, a1, a2, a3, a4, a5) \
76 ipc_irq_send_msg((irq), (a1), (a2), (a3), (a4), (a5))
77
78extern void ipc_irq_send_msg(irq_t *, sysarg_t, sysarg_t, sysarg_t, sysarg_t,
79 sysarg_t);
80
81#endif
82
83/** @}
84 */
Note: See TracBrowser for help on using the repository browser.