Documentation

acltdtAttachQueue

The Atlas 200/300/500 Inference Product does not support this API.

The Atlas Training Series Product does not support this API.

Description

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

Prototype

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

Parameters

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 value of wait 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.

Returns

The value 0 indicates success, and other values indicate failure. For details, see aclError.

Parent topic: Shared Queue Management