OpenHarmony LiteOS-A內核文檔之學習--系統調用（1）

OpenHarmony LiteOS-A內核文檔之學習–系統調用

OpenHarmony LiteOS-A內核實現態與內核態的區分隔離，用戶態程序不能直接訪問內核資源，而系統調用則為用戶態程序提供了一種訪問內核資源、與內核進行交互的通道。如下圖所示，用戶程序通過調用System API（系統API，通常是系統提供的POSIX接口）進行內核資源訪問與交互請求，POSIX接口內部會觸發SVC/SWI異常，完成系統從用戶態到內核態的切換，然后對接到內核的Syscall Handler（系統調用統一處理接口）進行參數解析，最終分發至具體的內核處理函數。

Syscall Handler的具體實現在kernel/liteos_a/syscall/los_syscall.c中OsArmA32SyscallHandle函數，在進入系統軟中斷異常時會調用此函數，并且按照kernel/liteos_a/syscall/syscall_lookup.h中的清單進行系統調用的入參解析，執行各系統調用最終對應的內核處理函數。

1. 涉及的系統調用文件目錄介紹

先介紹下系統調用相關的內核態代碼、用戶態代碼所在的文件目錄。

1.1 syscall/syscall_lookup.h文件

kernel/liteos_a/syscall/syscall_lookup.h文件中維護內核向用戶態提供的系統調用接口。文件中包含虛擬文件系統VFS、動態加載DYNLOAD、PIPE、SHELL、LWIP、SECURITY_CAPABILITY等模塊的系統調用接口，文件內容片段如下。每一個系統調用有宏函數SYSCALL_HAND_DEF定義，包含系統調用編號、系統調用處理函數，返回值類型，系統調用處理參數數目，下文詳細介紹。

...... SYSCALL_HAND_DEF(__NR_write, SysWrite, ssize_t, ARG_NUM_3) SYSCALL_HAND_DEF(__NR_open, SysOpen, int, ARG_NUM_7) SYSCALL_HAND_DEF(__NR_close, SysClose, int, ARG_NUM_1) SYSCALL_HAND_DEF(__NR_creat, SysCreat, int, ARG_NUM_2) ......

文件syscall/syscall_lookup.h被文件syscall/los_syscall.c中的系統調用初始化函數OsSyscallHandleInit調用，調用代碼如下。可以看出第一個參數是系統調用函數編號，編號定義在文件third_party/musl/porting/liteos_a/kernel/include/bits/syscall.h；第二個是系統調用函數，函數原型聲明在文件kernel/liteos_a/syscall/los_syscall.h，函數實現一般在kernel/liteos_a/syscall目錄下的源代碼文件中實現； 第三個是返回值類型，暫時沒有使用；第四個函數是系統調用函數的參數數目。

下面看下宏函數的代碼，⑴處把定義的系統調用函數都維護在全局數組g_syscallHandle。⑵處由于參數數量不會特別大，記錄系統調用處理函數參數數目的全局數組g_syscallNArgs的類型是UINT8，每4個bit位維護一個系統調用的參數數目。

... static UINTPTR g_syscallHandle[SYS_CALL_NUM] = {0}; static UINT8 g_syscallNArgs[(SYS_CALL_NUM + 1) / NARG_PER_BYTE] = {0}; ... void OsSyscallHandleInit(void) { #define SYSCALL_HAND_DEF(id, fun, rType, nArg) \ if ((id) < SYS_CALL_NUM) { \ ⑴ g_syscallHandle[(id)] = (UINTPTR)(fun); \ ⑵ g_syscallNArgs[(id) / NARG_PER_BYTE] |= ((id) & 1) ? (nArg) << NARG_BITS : (nArg); \ } \ #include "syscall_lookup.h" #undef SYSCALL_HAND_DEF } LOS_MODULE_INIT(OsSyscallHandleInit, LOS_INIT_LEVEL_KMOD_EXTENDED);

1.2 syscall/los_syscall.h文件

kernel/liteos_a/syscall/los_syscall.h文件中維護內核的系統調用對接函數聲明。函數實現一般在目錄/kernel/liteos_a/syscall下的源代碼文件中。該文件主要被如下源文件include使用。

./kernel/liteos_a/fs/vfs/vfs_cmd/vfs_shellcmd.c:50:#include "los_syscall.h" ./kernel/liteos_a/kernel/extended/blackbox/los_blackbox_core.c:46:#include "los_syscall.h" ./kernel/liteos_a/kernel/user/src/los_user_init.c:33:#include "los_syscall.h" ./kernel/liteos_a/syscall/fs_syscall.c:49:#include "los_syscall.h" ./kernel/liteos_a/syscall/los_syscall.c:38:#include "los_syscall.h" ./kernel/liteos_a/syscall/net_syscall.c:37:#include "los_syscall.h"

1.3 系統調用函數編號

維護系統調用編號文件有2個，需要分別在用戶態和內核態維護系統調用函數編號。除了文件porting/liteos_a/kernel/include/bits/syscall.h中多個幾個參數數目的宏定義外，下述兩個文件的內容基本相同。

third_party/musl/porting/liteos_a/user/arch/arm/bits/syscall.h.in

third_party/musl/porting/liteos_a/kernel/include/bits/syscall.h

2. 系統調用開發示例

當需要新增一個系統調用接口時，可以參考下述步驟：

在LibC庫中確定并添加新增的系統調用號。

在LibC庫中新增用戶態的函數接口聲明及實現。

在內核系統調用頭文件中確定并添加新增的系統調用號及對應內核處理函數的聲明。

在內核中新增該系統調用對應的內核處理函數。

2.1 在LibC庫中確定并添加新增的系統調用號

編輯文件porting/liteos_a/user/arch/arm/bits/syscall.h.in，如下所示，其中⑴處的__NR_new_syscall_sample為新增系統調用號。需要注意同時更新下⑵處的編號。

/* OHOS customized syscalls, not compatible with ARM EABI */ #define __NR_OHOS_BEGIN 500 #define __NR_pthread_set_detach (__NR_OHOS_BEGIN + 0) ...... #define __NR_sysconf (__NR_OHOS_BEGIN + 21) ⑴ #define __NR_new_syscall_sample (__NR_OHOS_BEGIN + 22) /* 新增的系統調用號 __NR_new_syscall_sample:522 */ ⑵ #define __NR_syscallend (__NR_OHOS_BEGIN + 23)

2.2 在LibC庫中新增用戶態的函數接口聲明及實現。

系統調用提供基礎的用戶態程序與內核的交互功能，不建議開發者直接使用系統調用接口，推薦使用內核提供的對外POSIX接口。需要在LibC庫中新增用戶態接口的聲明與實現。為了簡化，我們在現成的一個源文件里增加一函數實現代碼，如third_party/musl/porting/liteos_a/user/src/aio/aio.c文件中增加：

/* 新增系統調用用戶態的接口實現 */ void newSyscallSample(int num) { printf("user mode: num = %d\n", num); __syscall(SYS_new_syscall_sample, num); return; }

IoT 輕量級操作系統 LiteOS

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。