Lines Matching full:message
33 * @defgroup mqueue Message queue
60 * Maximum number of messages in a message queue
66 * Maximum size of a single message in a message queue
114 * Message queue attribute structure
117 long mq_flags; /**< Message queue flags */
119 long mq_msgsize; /**< Maximum size of a message */
120 long mq_curmsgs; /**< Number of messages in the current message queue */
125 * Handle type of a message queue
133 …* This API is used to open an existed message queue that has a specified name or create a new mess…
136 * <li>A message queue does not restrict the read and write permissions.</li>
143 * @param mqName [IN] Message queue name.
144 * @param openFlag [IN] Permission attributes of the message queue. The value range is
146 * @param mode [IN] Message queue mode (variadic argument). When oflag is O_CREAT, it requires
149 * @param attr [IN] Message queue attribute (variadic argument).
151 * @retval mqd_t The message queue is successfully opened or created.
152 …* @retval (mqd_t)-1 The message queue fails to be opened or created, with any of the following er…
157 …* <li><b>ENOENT</b>: O_CREAT flag is not set for oflag, and the message queue specified by name do…
158 * <li><b>EEXIST</b>: Both O_CREAT and O_EXCL are set for oflag, but the message queue
161 * <li><b>ENFILE</b>: The number of opened message queues exceeds the maximum limit.</li>
163 * <li><b>ENAMETOOLONG</b>: The message queue name specified by name is too long.</li>
176 * This API is used to close a message queue that has a specified descriptor.
179 …* <li> If the message queue is empty, it will be reclaimed, which is similar to when mq_unlink is …
182 * @param personal [IN] Message queue descriptor.
184 * @retval 0 The message queue is successfully closed.
185 …* @retval -1 The message queue fails to be closed, with either of the following error codes in …
189 * <li><b>EBADF</b>: Invalid message queue descriptor.</li>
190 * <li><b>EAGAIN</b>: Failed to delete the message queue.</li>
191 * <li><b>EFAULT</b>: Failed to free the message queue.</li>
205 * This API is used to remove a message queue that has a specified name.
208 …* <li> If the message queue is empty, it will be reclaimed, which is similar to when mq_close is c…
212 * @param mqName [IN] Message queue name.
214 * @retval 0 The message queue is successfully removed.
215 …* @retval -1 The message queue fails to be removed, with any of the following error codes in er…
219 * <li><b>ENOENT</b>: The message queue specified by name does not exist.</li>
220 * <li><b>EAGAIN</b>: Failed to delete the message queue.</li>
221 * <li><b>EBUSY</b>: The message queue to be removed is being used.</li>
236 * This API is used to put a message with specified message content and length into
237 * a message queue that has a specified descriptor.
240 * <li> Priority-based message processing is not supported.</li>
244 * @param personal [IN] Message queue descriptor.
245 * @param msg [IN] Pointer to the message content to be sent.
246 * @param msgLen [IN] Length of the message to be sent.
247 * @param msgPrio [IN] Priority of the message to be sent (the value of this parameter must
248 * be 0 because priority-based message sending is not supported. If the
251 * @retval 0 The message is successfully sent.
252 * @retval -1 The message fails to be sent, with any of the following error codes in errno.
256 * <li><b>EINTR</b>: An interrupt is in progress while the message is being sent.</li>
257 * <li><b>EBADF</b>: The message queue is invalid or not writable.</li>
258 * <li><b>EAGAIN</b>: The message queue is full.</li>
261 * <li><b>EMSGSIZE</b>: The message to be sent is too long.</li>
276 …* This API is used to remove the oldest message from the message queue that has a specified descri…
280 * <li> Priority-based message processing is not supported.</li>
284 * @param personal [IN] Message queue descriptor.
285 * @param msg [IN] Pointer to the message content to be received.
286 * @param msgLen [IN] Length of the message to be received.
287 * @param msgPrio [OUT] Priority of the message to be received
288 …* because priority-based message processing is not supported, this paramet…
290 * @retval 0 The message is successfully received.
291 …* @retval -1 The message fails to be received, with any of the following error codes in the err…
295 * <li><b>EINTR</b>: An interrupt is in progress while the message is being received.</li>
296 * <li><b>EBADF</b>: The message queue is invalid or not readable.</li>
297 * <li><b>EAGAIN</b>: The message queue is empty.</li>
299 * <li><b>EMSGSIZE</b>: The message to be received is too long.</li>
313 …* This API is used to obtain or modify attributes of the message queue that has a specified descri…
317 * in the message queue attribute setting.</li>
320 * @param personal [IN] Message queue descriptor.
321 * @param mqSetAttr [IN] New attribute of the message queue.
322 * @param MqOldAttr [OUT] Old attribute of the message queue.
324 * @retval 0 The message queue attributes are successfully set or get.
325 * @retval -1 The message queue attributes fail to be set or get,
330 * <li><b>EBADF</b>: Invalid message queue.</li>
344 * This API is used to put a message with specified message content and length into
345 * a message queue that has a descriptor at a scheduled time.
348 * <li> Priority-based message processing is not supported.</li>
354 * @param mqdes [IN] Message queue descriptor.
355 * @param msg [IN] Pointer to the message content to be sent.
356 * @param msgLen [IN] Length of the message to be sent.
357 …* @param msgPrio [IN] Priority of the message to be sent (the value of this parameter must…
358 * because priority-based message processing is not supported).
359 * @param absTimeout [IN] Scheduled time at which the message will be sent. If the value is 0,
360 * the message is an instant message.
362 * @retval 0 The message is successfully sent.
363 * @retval -1 The message fails to be sent, with any of the following error codes in errno.
367 * <li><b>EINTR</b>: An interrupt is in progress while the message is being sent.</li>
368 * <li><b>EBADF</b>: The message queue is invalid or not writable.</li>
369 * <li><b>EAGAIN</b>: The message queue is full.</li>
371 * <li><b>EMSGSIZE</b>: The message to be sent is too long.</li>
387 * This API is used to obtain a message with specified message content and length from
388 * a message queue message that has a specified descriptor.
391 * <li> Priority-based message processing is not supported.</li>
397 * @param personal [IN] Message queue descriptor.
398 * @param msg [IN] Pointer to the message content to be received.
399 * @param msgLen [IN] Length of the message to be received.
400 …* @param msgPrio [OUT] Priority of the message to be received (because priority-based mess…
403 * the message is an instant message.
405 * @retval 0 The message is successfully received.
406 * @retval -1 The message fails to be received, with any of the following error codes in errno.
410 * <li><b>EINTR</b>: An interrupt is in progress while the message is being received.</li>
411 * <li><b>EBADF</b>: The message queue is invalid or not readable.</li>
412 * <li><b>EAGAIN</b>: The message queue is empty.</li>
414 * <li><b>EMSGSIZE</b>: The message to be received is too long.</li>