source: trunk/hal/generic/hal_uspace.h @ 392

Last change on this file since 392 was 299, checked in by max@…, 7 years ago

The uspace strcpy function is allowed to fail (not implemented yet).

File size: 5.2 KB
RevLine 
[1]1/*
2 * hal_uspace.h - Generic User Space Access API definition
[17]3 *
[23]4 * Authors    Alain Greiner (2016,2017)
[1]5 *
6 * Copyright (c)  UPMC Sorbonne Universites
[17]7 *
[1]8 * This file is part of ALMOS-MKH.
9 *
10 * ALMOS-MKH is free software; you can redistribute it and/or modify it
11 * under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; version 2.0 of the License.
13 *
14 * ALMOS-MKH is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17 * General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with ALMOS-MKH; if not, write to the Free Software Foundation,
21 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
22 */
23
24#ifndef  _HAL_USPACE_H_
25#define  _HAL_USPACE_H_
26
27#include <hal_types.h>
28
29//////////////////////////////////////////////////////////////////////////////////////////
30//           User space access API (implementation in hal_uspace.c)
[17]31//
[1]32// When moving data between user space and kernel space, the user address is always
[95]33// a virtual address, but the kernel address can be a physical address, on 32 bits
34// architectures, and require MMU dynamic activation/deactivation.
35// For sake of portability, user/kernel data transfers must use the following API.
[1]36//////////////////////////////////////////////////////////////////////////////////////////
37
38
39/*****************************************************************************************
40 * This function tranfers a data buffer from the user space to the kernel space.
[23]41 * If the kernel uses physical addresses, it activates the MMU to access the user buffer.
[1]42 *****************************************************************************************
43 * @ k_dst     : destination address in kernel space.
44 * @ u_src     : source buffer address in user space.
45 * @ size      : size (number of bytes).
46 ****************************************************************************************/
47extern void hal_copy_from_uspace( void     * k_dst,
48                                  void     * u_src,
49                                  uint32_t   size );
50
51/*****************************************************************************************
52 * This function tranfers a data buffer from the kernel space to the user space.
[23]53 * If the kernel uses physical addresses, it activates the MMU to access the user buffer.
[1]54 *****************************************************************************************
[23]55 * @ u_dst     : destination buffer address in user space.
[1]56 * @ k_src     : source address in kernel space.
57 * @ size      : size (number of bytes).
58 ****************************************************************************************/
[23]59extern void hal_copy_to_uspace( void     * u_dst,
60                                void     * k_src,
[1]61                                uint32_t   size );
62
63/*****************************************************************************************
[95]64 * This function tranfers a NUL terminated string from the user space to the kernel space.
65 * If the kernel uses physical addresses, it activates the MMU to access the user buffer.
[299]66 * TODO : implement the max_size argument handling, and error handling
[95]67 *****************************************************************************************
68 * @ u_dst     : destination buffer address in user space.
69 * @ k_src     : source address in kernel space.
[121]70 * @ max_size  : max number of characters to be copied.
[95]71 ****************************************************************************************/
[299]72extern error_t hal_strcpy_from_uspace( char     * k_dst,
73                                       char     * u_src, 
74                                       uint32_t   max_size );
[95]75
76/*****************************************************************************************
77 * This function tranfers a NUL terminated string from the kernel space to the user space.
78 * If the kernel uses physical addresses, it activates the MMU to access the user buffer.
[299]79 * TODO : implement the max_size argument handling, and error handling
[95]80 *****************************************************************************************
81 * @ u_dst     : destination buffer address in user space.
82 * @ k_src     : source address in kernel space.
[121]83 * @ max_size  : max number of characters to be copied.
[95]84 ****************************************************************************************/
[299]85extern error_t hal_strcpy_to_uspace( char     * u_dst,
86                                     char     * k_src,
87                                     uint32_t   max_size );
[95]88
89/*****************************************************************************************
[23]90 * This function computes the length of a string in user space.
91 * If the kernel uses physical addresses, it activates the MMU to access the user buffer.
[1]92 *****************************************************************************************
93 * @ u_str     : string address in user space.
94 * @ return length of the string.
95 ****************************************************************************************/
[95]96uint32_t hal_strlen_from_uspace( char * string );
[1]97
98
99#endif  /* _HAL_USPACE_H_ */
Note: See TracBrowser for help on using the repository browser.