diff --git a/include/sys/ipc.h b/include/sys/ipc.h index 6c6d3f953a3..919b7676451 100644 --- a/include/sys/ipc.h +++ b/include/sys/ipc.h @@ -88,7 +88,29 @@ struct ipc_perm * Public Function Prototypes ****************************************************************************/ -key_t ftok(FAR const char *path, int id); +/**************************************************************************** + * Name: ftok + * + * Description: + * Convert a pathname and a project identifier to a System V IPC key. + * The ftok() function uses the identity of the file named by the given + * pathname (which must refer to an existing, accessible file) and the + * least significant 8 bits of proj_id (which must be nonzero) to + * generate a key_t type System V IPC key, suitable for use with + * msgget(2), semget(2), or shmget(2). + * + * Input Parameters: + * pathname - identity of the file name + * proj_id - The value that uniquely project identifies. + * + * Returned Value: + * On success, the generated key_t value is returned. + * On failure -1 is returned, with errno indicating the error as for the + * stat(2) system call. + * + ****************************************************************************/ + +key_t ftok(FAR const char *pathname, int proj_id); #undef EXTERN #if defined(__cplusplus) diff --git a/include/sys/types.h b/include/sys/types.h index 9d5952e5e99..475e59321bd 100644 --- a/include/sys/types.h +++ b/include/sys/types.h @@ -158,7 +158,7 @@ typedef int id_t; * semaphores. A key is simply an integer of type key_t */ -typedef int16_t key_t; +typedef int32_t key_t; /* Signed integral type of the result of subtracting two pointers */ diff --git a/libs/libc/misc/Make.defs b/libs/libc/misc/Make.defs index 0a73af711d8..405b9b40fe6 100644 --- a/libs/libc/misc/Make.defs +++ b/libs/libc/misc/Make.defs @@ -37,7 +37,7 @@ endif CSRCS += lib_dumpbuffer.c lib_dumpvbuffer.c lib_fnmatch.c lib_debug.c CSRCS += lib_crc64.c lib_crc32.c lib_crc16.c lib_crc8.c lib_crc8ccitt.c -CSRCS += lib_crc8table.c lib_glob.c lib_execinfo.c +CSRCS += lib_crc8table.c lib_glob.c lib_execinfo.c lib_ftok.c # Keyboard driver encoder/decoder diff --git a/libs/libc/misc/lib_ftok.c b/libs/libc/misc/lib_ftok.c new file mode 100644 index 00000000000..6d38ed62b18 --- /dev/null +++ b/libs/libc/misc/lib_ftok.c @@ -0,0 +1,69 @@ +/**************************************************************************** + * libs/libc/misc/lib_ftok.c + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. The + * ASF licenses this file to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance with the + * License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT + * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the + * License for the specific language governing permissions and limitations + * under the License. + * + ****************************************************************************/ + +/**************************************************************************** + * Included Files + ****************************************************************************/ + +#include + +#include +#include +#include + +/**************************************************************************** + * Public Functions + ****************************************************************************/ + +/**************************************************************************** + * Name: ftok + * + * Description: + * Convert a pathname and a project identifier to a System V IPC key. + * The ftok() function uses the identity of the file named by the given + * pathname (which must refer to an existing, accessible file) and the + * least significant 8 bits of proj_id (which must be nonzero) to + * generate a key_t type System V IPC key, suitable for use with + * msgget(2), semget(2), or shmget(2). + * + * Input Parameters: + * pathname - identity of the file name + * proj_id - The value that uniquely project identifies. + * + * Returned Value: + * On success, the generated key_t value is returned. + * On failure -1 is returned, with errno indicating the error as for the + * stat(2) system call. + * + ****************************************************************************/ + +key_t ftok(FAR const char *pathname, int proj_id) +{ + struct stat st; + + if (stat(pathname, &st) < 0) + { + return (key_t)-1; + } + + return ((key_t)proj_id << 24 | + (key_t)(st.st_dev & 0xff) << 16 | + (key_t)(st.st_ino & 0xffff)); +}