Linux → QNX 程序移植：API 差异与适配指南
Linux → QNX 程序移植：API 差异与适配指南
参考文档来源（QNX SDP 8.0）：
文档 链接 Migrating to QNX OS 8.0 https://www.qnx.com/developers/docs/8.0/com.qnx.doc.qnxsdp.migration/topic/about.html Migration Guidelines → C and C++ applications https://www.qnx.com/developers/docs/8.0/com.qnx.doc.qnxsdp.migration/topic/c_apps.html Programmer’s Guide → Handling Hardware Interrupts https://www.qnx.com/developers/docs/8.0/com.qnx.doc.neutrino.prog/topic/inthandler.html Programmer’s Guide → Working with Memory https://www.qnx.com/developers/docs/8.0/com.qnx.doc.neutrino.prog/topic/memory.html Getting Started with the QNX OS https://www.qnx.com/developers/docs/8.0/com.qnx.doc.neutrino.getting_started/topic/about.html
一、迁移涉及的文档章节索引
官方文档将迁移相关内容分布在以下章节：
QNX SDP 8.0 文档树 ├── Migrating to QNX OS 8.0 ← 迁移总入口 │ ├── Planning Your Migration │ └── Migration Guidelines │ ├── Kernel and process manager │ ├── Networking │ ├── Filesystems │ ├── Toolchain │ ├── Target-side command-line utilities │ ├── Security │ ├── Graphics and Screen │ ├── Audio │ ├── C and C++ applications ← C/C++ API 变化 │ └── Board Support Packages │ └── Programmer's Guide ← 新 API 使用方式 ├── QNX OS Architecture and Concepts ├── Processes ├── Handling Hardware Interrupts ← 中断 API ├── Working with Memory ← 内存 API └── Freedom from Hardware and Platform Dependencies二、C/C++ 库 API 变化（官方文档：Migration Guidelines → C and C++ applications）
2.1 已移除的函数（libc）
官方说明：“The following functions have been removed from libc”
| 已移除函数 | 替代方案 |
|---|---|
_smalloc() | malloc() |
_scalloc() | calloc() |
_srealloc() | realloc() |
_sfree() | free() |
2.2 已移除的函数（stdlib.h）
官方说明：“The following functions have been removed from stdlib.h”
| 已移除函数 | 替代方案 |
|---|---|
itoa() | snprintf() |
ltoa() | snprintf() |
lltoa() | snprintf() |
ultoa() | snprintf() |
ulltoa() | snprintf() |
utoa() | snprintf() |
替代示例：
// Linux 写法（QNX 已移除）charbuf[32];itoa(42,buf,10);// QNX 推荐写法charbuf[32];snprintf(buf,sizeof(buf),"%d",42);2.3 inotify 函数迁移
官方说明：“The inotify_* functions have moved from libc to a new library, libfsnotify.so”
| 函数 | Linux | QNX |
|---|---|---|
inotify_init() | libc 内置 | 需链接libfsnotify.so |
inotify_add_watch() | libc 内置 | 需链接libfsnotify.so |
inotify_rm_watch() | libc 内置 | 需链接libfsnotify.so |
# CMakeLists.txt 中需添加 target_link_libraries(myapp fsnotify)注意：QNX 还有原生的
ionotify()函数，与inotify完全不同，不要混淆。
2.4 C++ 语言标准
官方说明：“QNX SDP 8.0 offers support for C++17 and C++20 with libc++. (Support for C++11 and C++14 is discontinued.)”
| 版本 | QNX SDP 8.0 支持情况 |
|---|---|
| C++11 | ❌ 已停止支持 |
| C++14 | ❌ 已停止支持 |
| C++17 | ✅ 支持 |
| C++20 | ✅ 支持 |
二进制不兼容：无法在 QNX 8.0 上运行旧版本编译的二进制文件，必须重新编译。
三、IPC 机制 API 差异（核心变化）
这是 Linux → QNX 移植最大的差异。QNX 以消息传递为核心 IPC 机制。
3.1 Linux IPC vs QNX IPC 对比
| 功能 | Linux API | QNX 等效 API |
|---|---|---|
| 进程间通信（主要方式） | pipe、socket、msg queue | MsgSend()/MsgReceive()/MsgReply() |
| 共享内存 | shm_open()+mmap() | shm_open()+mmap()（POSIX 兼容） |
| 信号量 | sem_open()/sem_wait() | sem_open()/sem_wait()（POSIX 兼容） |
| 互斥锁 | pthread_mutex_* | pthread_mutex_*（POSIX 兼容） |
| 条件变量 | pthread_cond_* | pthread_cond_*（POSIX 兼容） |
| 事件通知 | eventfd/epoll | MsgSendPulse()/MsgReceivePulse() |
3.2 QNX 消息传递核心 API
// ====== 服务端（Server）======// 1. 创建通道intchid=ChannelCreate(0);// 2. 等待消息struct_msg_infoinfo;intrcvid=MsgReceive(chid,&msg,sizeof(msg),&info);// 3. 回复消息MsgReply(rcvid,EOK,&reply,sizeof(reply));// ====== 客户端（Client）======// 1. 连接到服务端通道