* EVL documentations issues
@ 2024-07-09 15:45 Giulio Moro
2024-07-09 15:51 ` Giulio Moro
2024-07-09 21:07 ` Philippe Gerum
0 siblings, 2 replies; 7+ messages in thread
From: Giulio Moro @ 2024-07-09 15:45 UTC (permalink / raw)
To: xenomai
Hi there,
going through the documentation for EVL I noticed the following:
- at https://evlproject.org/core/user-api/function_index/ the functions evl_udelay(), evl_new_clock(), evl_get_thread_mode() (at least) are not going anywhere and they are also not mentioned in the libevl source code.
- in practical use, evl_usleep() seems to have a limit of 1000000 as an argument. Is that expected? The limit is undocumented and the corresponding -EINVAL return value is also undocumented.
- evl_add_pollfd() and evl_mod_pollfd ()take an undocumented union evl_value pollval. The tests use evl_nil.
- there are several broken links. I found these with https://www.deadlinkchecker.com/ entering evlproject.org as the starting page. I report the result below for convenience, but the kast column "Source link text" is much more usable when viewed on the site as it is a clickable link to the page containing the broken link
Status URL Source link text
404 Not Found https://xenomai.org/documentation/xenomai-3/html/man1/latency/ Xenomai 3
404 Not Found https://docs.zephyrproject.org/latest/getting_started/installation_linux.html Zephyr SDK
404 Not Found https://source.denx.de/Xenomai/xenomai4/revl/-/tags/0.4.0 0.4.0 [302 from https://git.xenomai.org/xenomai4/revl/-/tags/0.4.0]
404 Not Found https://xenomai.org/documentation/xenomai-3/html/man1/latency/index.html latency
404 Not Found https://xenomai.org/documentation/xenomai-3/html/man1/autotune/index.html autotune
404 Not Found https://xenomai.org/documentation/xenomai-3/html/xeno3prm/group__cobalt__core.html Cobalt core
404 Not Found https://xenomai.org/documentation/xenomai-3/html/xeno3prm/group__rtdm.html RTDM
-1 Not found: The host name in the certificate is invalid or does not match https://rtai.org/ RTAI [302 from http://rtai.org/]
404 Not Found https://man7.org/linux/man-pages/man3/clock_nanosleep.3.html clock_nanosleep(3) [301 from http://man7.org/linux/man-pages/man3/clock_nanosleep.3.html]
404 Not Found https://man7.org/linux/man-pages/man2/fcntl.2.html) http://man7.org/linux/man-pages/man2/fcntl.2.html) [301 from http://man7.org/linux/man-pages/man2/fcntl.2.html)]
404 Not Found https://www.kernel.org/doc/html/latest/core-api/genericirq.html) https://www.kernel.org/doc/html/latest/core-api/genericirq.html)
404 Not Found https://source.denx.de/Xenomai/xenomai4/libevl/-/tags/r41 libevl r41 [302 from https://git.xenomai.org/xenomai4/libevl/-/tags/r41]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/7af18f8a38ad68f581cf770819ccb98c29f41586 20 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/7af18f8a38ad68f581cf770819ccb98c29f41586]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/41dc88ab524cd32878646d98b57d390e2bcc1198 26 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/41dc88ab524cd32878646d98b57d390e2bcc1198]
404 Not Found https://source.denx.de/Xenomai/xenomai4/libevl/-/tags/r40 r40 [302 from https://git.xenomai.org/xenomai4/libevl/-/tags/r40]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/87ee9586fa60 17 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/87ee9586fa60]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/231089ed6028 16 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/231089ed6028]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/6b8a2319c02d 15 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/6b8a2319c02d]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/3d4ff940c1d3 14 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/3d4ff940c1d3]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/a142e2e027dc 19 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/a142e2e027dc]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/b8351b703ffb 18 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/b8351b703ffb]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/9397204d7484 8 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/9397204d7484]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/c1a5ca6a70e7 7 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/c1a5ca6a70e7]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/bc92ac9d3b90 6 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/bc92ac9d3b90]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/d9b664b5ecdb 5 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/d9b664b5ecdb]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/57ce409e23e6 4 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/57ce409e23e6]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/b81555f4f48b 1 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/b81555f4f48b]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/cfab80b242c4 0 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/cfab80b242c4]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/f6f6e58cbaff 9 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/f6f6e58cbaff]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/c1417f3dbe4f 3 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/c1417f3dbe4f]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/3af3b43bdf20 2 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/3af3b43bdf20]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/a2ba90db409a 13 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/a2ba90db409a]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/0b5a64ead6f6 12 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/0b5a64ead6f6]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/b7c6e2276983 11 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/b7c6e2276983]
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/8245a892b9ec 10 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/8245a892b9ec]
404 Not Found https://evlproject.org/core/benchmarks/(/core/runtime-settings/) calibration settings
404 Not Found https://evlproject.org/core/user-api/io/_index.html oob_read()
404 Not Found https://evlproject.org/core/user-api/flags/(/core/abi-revs/) ABI 33
404 Not Found http://nanopi.io/nanopi-neo.html/ AllWinner H3 (NanoPI NEO)
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: EVL documentations issues
2024-07-09 15:45 EVL documentations issues Giulio Moro
@ 2024-07-09 15:51 ` Giulio Moro
2024-07-09 16:11 ` Philippe Gerum
2024-07-09 21:07 ` Philippe Gerum
1 sibling, 1 reply; 7+ messages in thread
From: Giulio Moro @ 2024-07-09 15:51 UTC (permalink / raw)
To: xenomai
Giulio Moro wrote on 09/07/2024 10:45:>
> - there are several broken links. I found these with https://www.deadlinkchecker.com/ entering evlproject.org as the starting page. I report the result below for convenience, but the kast column "Source link text" is much more usable when viewed on the site as it is a clickable link to the page containing the broken link
Here's a better plain-text version of the broken link report from the same source. Last column "Linked From" is the page that contains the broken link
Error URL Anchor Text Linked From
404 Not Found https://xenomai.org/documentation/xenomai-3/html/man1/latency/ Xenomai 3 https://evlproject.org/core/benchmarks/
404 Not Found https://evlproject.org/core/benchmarks/(/core/runtime-settings/) calibration settings https://evlproject.org/core/benchmarks/
404 Not Found https://docs.zephyrproject.org/latest/getting_started/installation_linux.html Zephyr SDK https://evlproject.org/core/benchmarks/
404 Not Found https://source.denx.de/Xenomai/xenomai4/revl/-/tags/0.4.0 0.4.0 [302 from https://git.xenomai.org/xenomai4/revl/-/tags/0.4.0] https://evlproject.org/
404 Not Found https://xenomai.org/documentation/xenomai-3/html/man1/latency/index.html latency https://evlproject.org/core/testing/
404 Not Found https://xenomai.org/documentation/xenomai-3/html/man1/autotune/index.html autotune https://evlproject.org/core/testing/
404 Not Found https://xenomai.org/documentation/xenomai-3/html/xeno3prm/group__cobalt__core.html Cobalt core https://evlproject.org/overview/
404 Not Found https://evlproject.org/core/user-api/io/_index.html oob_read() https://evlproject.org/core/user-api/function_index/
404 Not Found https://evlproject.org/core/user-api/flags/(/core/abi-revs/) ABI 33 https://evlproject.org/core/user-api/flags/
404 Not Found https://xenomai.org/documentation/xenomai-3/html/xeno3prm/group__rtdm.html RTDM https://evlproject.org/core/oob-drivers/
-1 Not found: The host name in the certificate is invalid or does not match https://rtai.org/ RTAI [302 from http://rtai.org/] https://evlproject.org/core/
404 Not Found https://man7.org/linux/man-pages/man3/clock_nanosleep.3.html clock_nanosleep(3) [301 from http://man7.org/linux/man-pages/man3/clock_nanosleep.3.html] https://evlproject.org/core/user-api/clock/
404 Not Found https://man7.org/linux/man-pages/man2/fcntl.2.html) http://man7.org/linux/man-pages/man2/fcntl.2.html) [301 from http://man7.org/linux/man-pages/man2/fcntl.2.html)] https://evlproject.org/core/user-api/poll/
404 Not Found https://www.kernel.org/doc/html/latest/core-api/genericirq.html) https://www.kernel.org/doc/html/latest/core-api/genericirq.html) https://evlproject.org/core/kernel-api/interrupts/
404 Not Found https://source.denx.de/Xenomai/xenomai4/libevl/-/tags/r41 libevl r41 [302 from https://git.xenomai.org/xenomai4/libevl/-/tags/r41] https://evlproject.org/core/user-api/api-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/7af18f8a38ad68f581cf770819ccb98c29f41586 20 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/7af18f8a38ad68f581cf770819ccb98c29f41586] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/41dc88ab524cd32878646d98b57d390e2bcc1198 26 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/41dc88ab524cd32878646d98b57d390e2bcc1198] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/libevl/-/tags/r40 r40 [302 from https://git.xenomai.org/xenomai4/libevl/-/tags/r40] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/87ee9586fa60 17 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/87ee9586fa60] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/231089ed6028 16 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/231089ed6028] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/6b8a2319c02d 15 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/6b8a2319c02d] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/3d4ff940c1d3 14 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/3d4ff940c1d3] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/a142e2e027dc 19 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/a142e2e027dc] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/b8351b703ffb 18 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/b8351b703ffb] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/b81555f4f48b 1 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/b81555f4f48b] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/cfab80b242c4 0 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/cfab80b242c4] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/f6f6e58cbaff 9 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/f6f6e58cbaff] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/9397204d7484 8 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/9397204d7484] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/c1a5ca6a70e7 7 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/c1a5ca6a70e7] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/bc92ac9d3b90 6 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/bc92ac9d3b90] https://evlproject.org/core/abi-revs/
404 Not Found http://nanopi.io/nanopi-neo.html/ AllWinner H3 (NanoPI NEO) https://evlproject.org/ports/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/d9b664b5ecdb 5 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/d9b664b5ecdb] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/57ce409e23e6 4 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/57ce409e23e6] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/c1417f3dbe4f 3 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/c1417f3dbe4f] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/3af3b43bdf20 2 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/3af3b43bdf20] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/a2ba90db409a 13 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/a2ba90db409a] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/0b5a64ead6f6 12 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/0b5a64ead6f6] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/b7c6e2276983 11 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/b7c6e2276983] https://evlproject.org/core/abi-revs/
404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/8245a892b9ec 10 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/8245a892b9ec] https://evlproject.org/core/abi-revs/
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: EVL documentations issues
2024-07-09 15:51 ` Giulio Moro
@ 2024-07-09 16:11 ` Philippe Gerum
0 siblings, 0 replies; 7+ messages in thread
From: Philippe Gerum @ 2024-07-09 16:11 UTC (permalink / raw)
To: Giulio Moro, xenomai
Giulio Moro <giulio@bela.io> writes:
> Giulio Moro wrote on 09/07/2024 10:45:>
>> - there are several broken links. I found these with https://www.deadlinkchecker.com/ entering evlproject.org as the starting page. I report the result below for convenience, but the kast column "Source link text" is much more usable when viewed on the site as it is a clickable link to the page containing the broken link
>
> Here's a better plain-text version of the broken link report from the same source. Last column "Linked From" is the page that contains the broken link
>
> Error URL Anchor Text Linked From
> 404 Not Found https://xenomai.org/documentation/xenomai-3/html/man1/latency/ Xenomai 3 https://evlproject.org/core/benchmarks/
> 404 Not Found https://evlproject.org/core/benchmarks/(/core/runtime-settings/) calibration settings https://evlproject.org/core/benchmarks/
> 404 Not Found https://docs.zephyrproject.org/latest/getting_started/installation_linux.html Zephyr SDK https://evlproject.org/core/benchmarks/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/revl/-/tags/0.4.0 0.4.0 [302 from https://git.xenomai.org/xenomai4/revl/-/tags/0.4.0] https://evlproject.org/
> 404 Not Found https://xenomai.org/documentation/xenomai-3/html/man1/latency/index.html latency https://evlproject.org/core/testing/
> 404 Not Found https://xenomai.org/documentation/xenomai-3/html/man1/autotune/index.html autotune https://evlproject.org/core/testing/
> 404 Not Found https://xenomai.org/documentation/xenomai-3/html/xeno3prm/group__cobalt__core.html Cobalt core https://evlproject.org/overview/
> 404 Not Found https://evlproject.org/core/user-api/io/_index.html oob_read() https://evlproject.org/core/user-api/function_index/
> 404 Not Found https://evlproject.org/core/user-api/flags/(/core/abi-revs/) ABI 33 https://evlproject.org/core/user-api/flags/
> 404 Not Found https://xenomai.org/documentation/xenomai-3/html/xeno3prm/group__rtdm.html RTDM https://evlproject.org/core/oob-drivers/
> -1 Not found: The host name in the certificate is invalid or does not match https://rtai.org/ RTAI [302 from http://rtai.org/] https://evlproject.org/core/
> 404 Not Found https://man7.org/linux/man-pages/man3/clock_nanosleep.3.html clock_nanosleep(3) [301 from http://man7.org/linux/man-pages/man3/clock_nanosleep.3.html] https://evlproject.org/core/user-api/clock/
> 404 Not Found https://man7.org/linux/man-pages/man2/fcntl.2.html) http://man7.org/linux/man-pages/man2/fcntl.2.html) [301 from http://man7.org/linux/man-pages/man2/fcntl.2.html)] https://evlproject.org/core/user-api/poll/
> 404 Not Found https://www.kernel.org/doc/html/latest/core-api/genericirq.html) https://www.kernel.org/doc/html/latest/core-api/genericirq.html) https://evlproject.org/core/kernel-api/interrupts/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/libevl/-/tags/r41 libevl r41 [302 from https://git.xenomai.org/xenomai4/libevl/-/tags/r41] https://evlproject.org/core/user-api/api-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/7af18f8a38ad68f581cf770819ccb98c29f41586 20 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/7af18f8a38ad68f581cf770819ccb98c29f41586] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/41dc88ab524cd32878646d98b57d390e2bcc1198 26 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/41dc88ab524cd32878646d98b57d390e2bcc1198] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/libevl/-/tags/r40 r40 [302 from https://git.xenomai.org/xenomai4/libevl/-/tags/r40] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/87ee9586fa60 17 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/87ee9586fa60] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/231089ed6028 16 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/231089ed6028] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/6b8a2319c02d 15 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/6b8a2319c02d] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/3d4ff940c1d3 14 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/3d4ff940c1d3] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/a142e2e027dc 19 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/a142e2e027dc] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/b8351b703ffb 18 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/b8351b703ffb] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/b81555f4f48b 1 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/b81555f4f48b] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/cfab80b242c4 0 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/cfab80b242c4] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/f6f6e58cbaff 9 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/f6f6e58cbaff] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/9397204d7484 8 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/9397204d7484] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/c1a5ca6a70e7 7 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/c1a5ca6a70e7] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/bc92ac9d3b90 6 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/bc92ac9d3b90] https://evlproject.org/core/abi-revs/
> 404 Not Found http://nanopi.io/nanopi-neo.html/ AllWinner H3 (NanoPI NEO) https://evlproject.org/ports/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/d9b664b5ecdb 5 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/d9b664b5ecdb] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/57ce409e23e6 4 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/57ce409e23e6] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/c1417f3dbe4f 3 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/c1417f3dbe4f] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/3af3b43bdf20 2 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/3af3b43bdf20] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/a2ba90db409a 13 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/a2ba90db409a] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/0b5a64ead6f6 12 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/0b5a64ead6f6] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/b7c6e2276983 11 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/b7c6e2276983] https://evlproject.org/core/abi-revs/
> 404 Not Found https://source.denx.de/Xenomai/xenomai4/linux-evl/-/commit/8245a892b9ec 10 [302 from https://git.xenomai.org/xenomai4/linux-evl/-/commit/8245a892b9ec] https://evlproject.org/core/abi-revs/
Thanks for the heads up. Fixing in progress.
--
Philippe.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: EVL documentations issues
2024-07-09 15:45 EVL documentations issues Giulio Moro
2024-07-09 15:51 ` Giulio Moro
@ 2024-07-09 21:07 ` Philippe Gerum
2024-07-09 22:07 ` Giulio Moro
1 sibling, 1 reply; 7+ messages in thread
From: Philippe Gerum @ 2024-07-09 21:07 UTC (permalink / raw)
To: Giulio Moro; +Cc: xenomai
Giulio Moro <giulio@bela.io> writes:
> Hi there,
> going through the documentation for EVL I noticed the following:
> - at https://evlproject.org/core/user-api/function_index/ the
> functions evl_udelay(),
Mm, legacy name which eventually became evl_usleep() in order to match usleep(3).
> evl_new_clock(),
Once a forward looking statement which did not go anywhere
eventually. We don't need that call, a custom clock can be accessed by
opening the corresponding clock device in the /dev/evl/clock hierarchy
as soon as some EVL driver implements and advertises it to the EVL
core. The returned fd can be used with the generic oob_read/write()
calls to submit requests to such clock.
> evl_get_thread_mode() (at least) are not going anywhere and they are also not mentioned in the libevl source code.
This fell into the cracks in the early days. This would be an alias to
evl_set_thread_mode(fd, 0, &oldmask), with oldmask containing the
current state.
> - in practical use, evl_usleep() seems to have a limit of 1000000 as an argument. Is that expected? The limit is undocumented and the corresponding -EINVAL return value is also undocumented.
Yes, the 1sec limit is wanted, for longer sleeps evl_sleep_until() can
be used with an absolute timeout though. Documentation mentioning EINVAL
was indeed missing though, fixed now.
> - evl_add_pollfd() and evl_mod_pollfd ()take an undocumented union evl_value pollval. The tests use evl_nil.
Doc is upcoming.
> - there are several broken links. I found these with https://www.deadlinkchecker.com/ entering evlproject.org as the starting page. I report the result below for convenience, but the kast column "Source link text" is much more usable when viewed on the site as it is a clickable link to the page containing the broken link
>
>
Thanks, all fixed now.
--
Philippe.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: EVL documentations issues
2024-07-09 21:07 ` Philippe Gerum
@ 2024-07-09 22:07 ` Giulio Moro
2024-07-10 8:51 ` Philippe Gerum
0 siblings, 1 reply; 7+ messages in thread
From: Giulio Moro @ 2024-07-09 22:07 UTC (permalink / raw)
To: Philippe Gerum; +Cc: xenomai
Thanks for getting the fixes in.
This one is still wrong:
> -EINVAL if usecs is invalid, i.e. not in the [1..1000] range.
It should be [1..1000000] ...
I am also wondering whether returning -EINVAL when the argument is 0 is the best choice. FWIW, usleep(0) returns 0. I believe I have seen code use usleep(0) as an equivalent to sched_yield(), which I guess evl_usleep() would be "for free" if it didn't do the early return for usecs < 1 : evl_sleep_until() would return immediately because `next` would be in the past. Similarly glibc (I checked 2.39) goes through with the sleep even if the argument is 0. I guess the rationale would be that no matter of short the sleep, it should always at least cause a reschedule. As this function aims "to match usleep(3)", maybe it's worth considering using the same approach?
Also evl_get_thread_mode() hasn't yet been removed from the function list.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: EVL documentations issues
2024-07-09 22:07 ` Giulio Moro
@ 2024-07-10 8:51 ` Philippe Gerum
2024-07-10 12:40 ` Giulio Moro
0 siblings, 1 reply; 7+ messages in thread
From: Philippe Gerum @ 2024-07-10 8:51 UTC (permalink / raw)
To: Giulio Moro; +Cc: xenomai
Giulio Moro <giulio@bela.io> writes:
> Thanks for getting the fixes in.
>
> This one is still wrong:
>
>> -EINVAL if usecs is invalid, i.e. not in the [1..1000] range.
>
> It should be [1..1000000] ...
>
> I am also wondering whether returning -EINVAL when the argument is 0
> is the best choice. FWIW, usleep(0) returns 0. I believe I have seen
> code use usleep(0) as an equivalent to sched_yield(), which I guess
> evl_usleep() would be "for free" if it didn't do the early return for
> usecs < 1 : evl_sleep_until() would return immediately because `next`
> would be in the past. Similarly glibc (I checked 2.39) goes through
> with the sleep even if the argument is 0. I guess the rationale would
> be that no matter of short the sleep, it should always at least cause
> a reschedule. As this function aims "to match usleep(3)", maybe it's
> worth considering using the same approach?
>
I'm unsure usleep(0) should amount to a manual round-robin, at the very
least the POSIX standard does not states that [1]. I cannot find any
explicit reference to such behavior in the manpages either. However,
evl_usleep() seems wrong nevertheless regarding this if we want to stay
close to the POSIX behavior when this makes sense.
evl_yield() may be what you are looking for in order to do a manual
round-robin.
> Also evl_get_thread_mode() hasn't yet been removed from the function list.
Fixed, thanks.
[1] https://pubs.opengroup.org/onlinepubs/7908799/xsh/usleep.html
--
Philippe.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: EVL documentations issues
2024-07-10 8:51 ` Philippe Gerum
@ 2024-07-10 12:40 ` Giulio Moro
0 siblings, 0 replies; 7+ messages in thread
From: Giulio Moro @ 2024-07-10 12:40 UTC (permalink / raw)
To: Philippe Gerum; +Cc: xenomai
> I'm unsure usleep(0) should amount to a manual round-robin, at the very
> least the POSIX standard does not states that [1]. I cannot find any
> explicit reference to such behavior in the manpages either. However,
> evl_usleep() seems wrong nevertheless regarding this if we want to stay
> close to the POSIX behavior when this makes sense.
You are right. The Linux man page on my systems doesn't mention that the call has no effect is the argument is 0, rather it says "suspends execution of the calling thread for (at least) usec microseconds" which hints that a suspension of the calling thread happens even if the argument is 0. The POSIX.1-2001 page instead states explicitly that if the argument is 0 the call has no effect. Either way, it seems that usleep() should return 0 and not EINVAL when the argument is 0. It's up to you to decide how evl_usleep() should behave in that respect.
Best,
Giulio
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2024-07-10 13:17 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-07-09 15:45 EVL documentations issues Giulio Moro
2024-07-09 15:51 ` Giulio Moro
2024-07-09 16:11 ` Philippe Gerum
2024-07-09 21:07 ` Philippe Gerum
2024-07-09 22:07 ` Giulio Moro
2024-07-10 8:51 ` Philippe Gerum
2024-07-10 12:40 ` Giulio Moro
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.