abc/lwip
1
0
Fork 0
mirror of https://git.savannah.nongnu.org/git/lwip.git synced 2026-05-12 19:26:52 +08:00
Code Issues Packages Projects Releases Wiki Activity

[PATCH] Deprecate sys_arch_sem_wait and sys_arch_mbox_fetch returning the time waited

Browse Source 
These are now defined to return != SYS_ARCH_TIMEOUT on success rather than the time
waiting. The returned times were unused by lwip and this simplifies at
least some implementations.

Signed-off-by: goldsimon <goldsimon@gmx.de>
This commit is contained in:
Our Air Quality
2017-07-20 22:04:34 +02:00
committed by goldsimon
parent 597d5459bb
commit f934ca7a03
3 changed files with 16 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
doc/sys_arch.txt
View File

@@ -64,17 +64,14 @@ The following functions must be implemented by the sys_arch:
- u32_t sys_arch_sem_wait(sys_sem_t *sem, u32_t timeout)
Blocks the thread while waiting for the semaphore to be
signaled. If the "timeout" argument is non-zero, the thread should
only be blocked for the specified time (measured in
milliseconds). If the "timeout" argument is zero, the thread should be
blocked until the semaphore is signalled.
Blocks the thread while waiting for the semaphore to be signaled. If the
"timeout" argument is non-zero, the thread should only be blocked for the
specified time (measured in milliseconds). If the "timeout" argument is zero,
the thread should be blocked until the semaphore is signalled.
If the timeout argument is non-zero, the return value is the number of
milliseconds spent waiting for the semaphore to be signaled. If the
semaphore wasn't signaled within the specified time, the return value is
SYS_ARCH_TIMEOUT. If the thread didn't have to wait for the semaphore
(i.e., it was already signaled), the function may return zero.
The return value is SYS_ARCH_TIMEOUT if the semaphore wasn't signaled within
the specified time or any other value if it was signaled (with or without
waiting).
Notice that lwIP implements a function with a similar name,
sys_sem_wait(), that uses the sys_arch_sem_wait() function.
@@ -164,8 +161,8 @@ The following functions must be implemented by the sys_arch:
should be dropped.
The return values are the same as for the sys_arch_sem_wait() function:
Number of milliseconds spent waiting or SYS_ARCH_TIMEOUT if there was a
timeout.
SYS_ARCH_TIMEOUT if there was a timeout, any other value if a messages
is received.
Note that a function with a similar name, sys_mbox_fetch(), is
implemented by lwIP.