Linux -- ftok函数

翻译自Ubuntu 19版本下的Linux Programmer's Manual

1. 函数名：ftok – 将一个路径名和一个对象标识符转换为System V IPC键值。
2. 概要：

   #include <sys/types.h>
          #include <sys/ipc.h>
   
          key_t ftok(const char *pathname, int proj_id);
   

3. 描述：
     函数的作用是:使用指定以pathname(必须引用现有的、可访问的文件)命名的文件标识和proj_id(必须非零）的8位最小有效的整型值，生成一个以key_t为类型的System V IPC键值。适合与msgget(2)、semget(2)或shmget(2)一起使用。
     当使用相同的proj_id值时，对于所有以pathname命名的相同文件，结果值是相同的。当(同时存在的)pathname或项目proj_id不同时，返回的值应该不同。
     换另一句话说，这个函数的作用是为了能让多个进程通信（消息队列、共享内存），需要使用相同的键值来让多个进程引用同一块内存区域。
4. 返回值：
     成功时，将返回生成的key_t值。失败时返回-1,errno以stat(2)的错误值来表示。
5. 注意：
     在一些老旧的系统中，原型是:
        key_t ftok(char *pathname, char proj_id);
     现在，proj_id是一个int型，但仍然只有8位被使用。典型的用法是将一个ASCII码作为proj_id，这就是为什么当proj_id为0时，该行为被说成未定义。