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

Last change on this file since 639 was 637, checked in by alain, 5 years ago

Introduce the non-standard pthread_parallel_create() system call
and re-write the <fft> and <sort> applications to improve the
intrinsic paralelism in applications.
File size: 4.9 KB
RevLine 
[1]1/*
2 * hal_uspace.h - Generic User Space Access API definition
[17]3 *
[626]4 * Authors    Alain Greiner (2016,2017,2018,2019)
[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
[457]27#include <hal_kernel_types.h>
[1]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
[637]33// a virtual address, but the kernel address is an extended pointer.
[95]34// For sake of portability, user/kernel data transfers must use the following API.
[1]35//////////////////////////////////////////////////////////////////////////////////////////
36
37
38/*****************************************************************************************
[626]39 * This function tranfers a data buffer in user space to a kernel buffer
40 * that can be located in any cluster.
[1]41 *****************************************************************************************
[637]42 * @ k_dst_xp  : extended pointer on kernel destination buffer.
43 * @ u_src_ptr : source buffer address in user space.
[1]44 * @ size      : size (number of bytes).
45 ****************************************************************************************/
[637]46extern void hal_copy_from_uspace( xptr_t     k_dst_xp,
47                                  void     * u_src_ptr,
[1]48                                  uint32_t   size );
49
50/*****************************************************************************************
[626]51 * This function tranfers a kernel buffer that can be located in any cluster
52 * to a data buffer in the user space.
[1]53 *****************************************************************************************
[637]54 * @ u_dst_ptr : destination buffer address in user space.
55 * @ k_src_xp  : extended pointer on kernel source buffer.
[1]56 * @ size      : size (number of bytes).
57 ****************************************************************************************/
[637]58extern void hal_copy_to_uspace( void     * u_dst_ptr,
59                                xptr_t     k_src_xp, 
[1]60                                uint32_t   size );
61
62/*****************************************************************************************
[407]63 * This function tranfers a string from the user space to the kernel space.
64 * The transfer stops after the first encountered NUL character, and no more than
65 * <max_size> characters are actually copied to target buffer.
[95]66 *****************************************************************************************
[637]67 * @ k_dst_xp  : extended pointer on kernel destination buffer.
68 * @ u_src_ptr : source address in user space.
[121]69 * @ max_size  : max number of characters to be copied.
[95]70 ****************************************************************************************/
[637]71extern void hal_strcpy_from_uspace( xptr_t     k_dst_xp,
72                                    char     * u_src_ptr,
[407]73                                    uint32_t   max_size );
[95]74
75/*****************************************************************************************
[407]76 * This function tranfers a string from the kernel space to the user space.
77 * The transfer stops after the first encountered NUL character, and no more than
78 * <max_size> characters are actually copied to target buffer.
[95]79 *****************************************************************************************
[637]80 * @ u_dst_ptr : destination buffer address in user space.
81 * @ k_src_xp  : extended pointer on kernel source buffer.
[121]82 * @ max_size  : max number of characters to be copied.
[95]83 ****************************************************************************************/
[637]84extern void hal_strcpy_to_uspace( char     * u_dst_ptr,
85                                  xptr_t     k_src_xp,
[407]86                                  uint32_t   max_size );
[95]87
88/*****************************************************************************************
[23]89 * This function computes the length of a string in user space.
[1]90 *****************************************************************************************
[570]91 * @ string     : string in user space.
[1]92 * @ return length of the string.
93 ****************************************************************************************/
[95]94uint32_t hal_strlen_from_uspace( char * string );
[1]95
96
97#endif  /* _HAL_USPACE_H_ */
Note: See TracBrowser for help on using the repository browser.