acltdtAttachQueue

Product	Supported
Atlas 350 Accelerator Card	☓
Atlas A3 training product/Atlas A3 inference product	☓
Atlas A2 training product/Atlas A2 inference product	☓
Atlas 200I/500 A2 inference product	☓
Atlas inference product	☓
Atlas training product	☓

Confirms that the current process has the specified permission on a queue when queue information needs to be shared between processes.

aclError acltdtAttachQueue(uint32_t qid, int32_t timeout, uint32_t *permission)

Parameter	Input/Output	Description
qid	Input	Queue ID.
timeout	Input	Wait timeout interval. The options are as follows: -1: blocking mode. The system waits until data is successfully added to the queue. 0: non-blocking mode. Data is returned immediately. > 0: configures specific timeout interval, in ms. An error is returned after the timeout interval has reached. The timeout interval varies with the operating system. The deviation is generally within a time slice of an operating system. For example, if the time slice of an operating system is 4 ms and the timeout interval is set to 1 ms, the actual timeout interval ranges from 1 ms to 5 ms. When the CPU load is high, the timeout interval may fluctuate.
permission	Output	Permission flag. The last bit of the output parameter value is used to determine whether the process has the management permission. 0 indicates no; 1 indicates yes. The last but one bit of the output parameter value is used to determine whether the process has the dequeue permission. 0 indicates no; 1 indicates yes. The last but two bit of the output parameter value is used to determine whether the process has the enqueue permission. 0 indicates no; 1 indicates yes.

Parameter

Input/Output

Description

qid

Input

Queue ID.

timeout

Input

Wait timeout interval. The options are as follows:

-1: blocking mode. The system waits until data is successfully added to the queue.
0: non-blocking mode. Data is returned immediately.
> 0: configures specific timeout interval, in ms. An error is returned after the timeout interval has reached.
The timeout interval varies with the operating system. The deviation is generally within a time slice of an operating system. For example, if the time slice of an operating system is 4 ms and the timeout interval is set to 1 ms, the actual timeout interval ranges from 1 ms to 5 ms. When the CPU load is high, the timeout interval may fluctuate.

permission

Output

Permission flag.

The last bit of the output parameter value is used to determine whether the process has the management permission. 0 indicates no; 1 indicates yes.
The last but one bit of the output parameter value is used to determine whether the process has the dequeue permission. 0 indicates no; 1 indicates yes.
The last but two bit of the output parameter value is used to determine whether the process has the enqueue permission. 0 indicates no; 1 indicates yes.

0 on success; otherwise, failure. For details, see aclError.

Parent topic: Shared Queue Management