summaryrefslogtreecommitdiff
path: root/meta/3rd/OpenResty/library/ngx/semaphore.lua
diff options
context:
space:
mode:
Diffstat (limited to 'meta/3rd/OpenResty/library/ngx/semaphore.lua')
m---------meta/3rd/OpenResty0
-rw-r--r--meta/3rd/OpenResty/library/ngx/semaphore.lua66
2 files changed, 0 insertions, 66 deletions
diff --git a/meta/3rd/OpenResty b/meta/3rd/OpenResty
new file mode 160000
+Subproject 3bec36f0f645bb38b3c8208990d5c36feb66ce3
diff --git a/meta/3rd/OpenResty/library/ngx/semaphore.lua b/meta/3rd/OpenResty/library/ngx/semaphore.lua
deleted file mode 100644
index cd5c7586..00000000
--- a/meta/3rd/OpenResty/library/ngx/semaphore.lua
+++ /dev/null
@@ -1,66 +0,0 @@
----@meta
-
----@class ngx.semaphore
---- sem is the internal c handler
----@field sem userdata
-local semaphore = {
- version = require("resty.core.base").version,
-}
-
----Creates and returns a new semaphore instance.
----
----@param n? integer the number of resources the semaphore will begin with (default 0)
----@return ngx.semaphore? semaphore
----@return string? error
-function semaphore.new(n) end
-
-
---- Returns the number of resources readily available in the sema semaphore
---- instance (if any).
----
---- When the returned number is negative, it means the number of "light threads"
---- waiting on this semaphore.
----
----@return integer count
-function semaphore:count() end
-
-
---- Requests a resource from the semaphore instance.
----
---- Returns `true` immediately when there is resources available for the current
---- running "light thread". Otherwise the current "light thread" will enter the
---- waiting queue and yield execution. The current "light thread" will be
---- automatically waken up and the wait function call will return true when there
---- is resources available for it, or return nil and a string describing the error
---- in case of failure (like "timeout").
----
---- The timeout argument specifies the maximum time this function call should
---- wait for (in seconds).
----
---- When the timeout argument is 0, it means "no wait", that is, when there is
---- no readily available "resources" for the current running "light thread",
---- this wait function call returns immediately nil and the error string "timeout".
----
---- You can specify millisecond precision in the timeout value by using floating
---- point numbers like 0.001 (which means 1ms).
----
---- "Light threads" created by different contexts (like request handlers) can
---- wait on the same semaphore instance without problem.
----
----@param timeout? number
----@return boolean ok
----@return string|'"timeout"' error
-function semaphore:wait(timeout) end
-
-
---- Releases n (default to 1) "resources" to the semaphore instance.
----
---- This will not yield the current running "light thread".
----
---- At most n "light threads" will be waken up when the current running "light thread" later yields (or terminates).
----
----@param n? integer
-function semaphore:post(n) end
-
-
-return semaphore \ No newline at end of file