Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

nrf_modem: doc: cleanup function references #42

Closed
wants to merge 16 commits into from

Conversation

anhmolt
Copy link
Collaborator

@anhmolt anhmolt commented Feb 21, 2024

  • Clean up function references. Add nrf_accept and nrf_setdnsaddr to list of supported functions.
  • Remove superfluous nrf_errno mentions when referencing specific errnos for the NRF_SO_SEC_DTLS_CONN_SAVE and NRF_SO_SEC_DTLS_CONN_LOAD socket options.

@anhmolt anhmolt force-pushed the nrf_modem-doc-improvements branch from 90085c4 to c31b38d Compare February 22, 2024 09:18
Copy link
Collaborator

@MirkoCovizzi MirkoCovizzi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice cleanup. Added some suggestions.

nrf_modem/doc/fault_handling.rst Outdated Show resolved Hide resolved
nrf_modem/doc/fault_handling.rst Outdated Show resolved Hide resolved
nrf_modem/doc/sockets/socket_options_func.rst Outdated Show resolved Hide resolved
nrf_modem/doc/sockets/socket_options_func.rst Outdated Show resolved Hide resolved
nrf_modem/doc/sockets/socket_options_func.rst Outdated Show resolved Hide resolved
nrf_modem/doc/sockets/socket_options_func.rst Outdated Show resolved Hide resolved
nrf_modem/doc/sockets/socket_options_func.rst Outdated Show resolved Hide resolved
nrf_modem/doc/sockets/socket_options_func.rst Outdated Show resolved Hide resolved
@@ -17,23 +17,25 @@ Following is a list of supported functions:

* :c:func:`nrf_socket`
* :c:func:`nrf_close`
* :c:func:`nrf_fcntl`
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How did you re-arrange this list?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same order as in nrf_socket.h. We can drop re-arranging if you think that is better.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved re-arranging to separate commit.

Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the order of those functions in nrf_socket.h could be improved, it seems a bit random.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, agree.

nrf_modem/doc/sockets/socket_options_func.rst Outdated Show resolved Hide resolved
@anhmolt anhmolt force-pushed the nrf_modem-doc-improvements branch 5 times, most recently from 163dcd6 to 8243cc7 Compare February 23, 2024 08:56
nrf_modem/doc/fault_handling.rst Outdated Show resolved Hide resolved
nrf_modem/doc/fault_handling.rst Outdated Show resolved Hide resolved
MirkoCovizzi and others added 14 commits February 23, 2024 12:17
This commit updates the documentation to remove the custom
types `nrf_sec_cipher_t`, `nrf_sec_peer_verify_t`,
`nrf_sec_role_t`, and `nrf_sec_session_cache_t`.

Signed-off-by: Mirko Covizzi <[email protected]>
This commit extends the documentation
explaining how to use the special
security tags reserved for TLS traffic decryption.

Signed-off-by: Mirko Covizzi <[email protected]>
This commit updates the documentation to remove the deprecated `NRF_SO_RAI_` socket options.
This commit updates the documentation to add the `NRF_SO_RAI` socket
option and the `NRF_RAI_NO_DATA`, `NRF_RAI_LAST`, `NRF_RAI_ONE_RESP`,
`NRF_RAI_ONGOING`, and `NRF_RAI_WAIT_MORE` values.
Added documentation page for RAI.

Signed-off-by: Mirko Covizzi <[email protected]>
This commit rearranges the socket options in the table
to align with the order of the socket option descriptions
under the table.

Signed-off-by: Mirko Covizzi <[email protected]>
This commit moves `Socket options and functions`, `PDN`, `TLS/DTLS`,
and `RAI` from `sockets.rst` to the `sockets` subfolder in their
own respective document page.

Signed-off-by: Mirko Covizzi <[email protected]>
Co-authored-by: divya pillai <[email protected]>
This commit updates the layout of the socket
subpages to align with style guidelines.

Signed-off-by: divya pillai <[email protected]>
Signed-off-by: Mirko Covizzi <[email protected]>
This commit fixes a minor typo.

Signed-off-by: Mirko Covizzi <[email protected]>
This commit moves some text to a more
fitting paragraph.

Signed-off-by: Mirko Covizzi <[email protected]>
Removed redundant sentence.

Signed-off-by: Mirko Covizzi <[email protected]>
This commit adds documentation for raw sockets.

Signed-off-by: Mirko Covizzi <[email protected]>
* Add CFUN callbacks to doc.
* Add mutexes to documentation.

Signed-off-by: Eivind Jølsgard <[email protected]>
Add documentation for new feature.

Signed-off-by: Emanuele Di Santo <[email protected]>
Use :c:macro: for errnos.

Signed-off-by: Eivind Jølsgard <[email protected]>
The NRF_SO_RCVTIMEO is used to set the timeout in accept.

Signed-off-by: Eivind Jølsgard <[email protected]>
Clean up function references.
Add nrf_accept and nrf_setdnsaddr to list of supported functions.

Signed-off-by: Andreas Moltumyr <[email protected]>
Change nrf_errno mentions to simply errno when referencing specific
errnos for the NRF_SO_SEC_DTLS_CONN_SAVE and
NRF_SO_SEC_DTLS_CONN_LOAD socket options.

Signed-off-by: Andreas Moltumyr <[email protected]>
@anhmolt anhmolt force-pushed the nrf_modem-doc-improvements branch 2 times, most recently from ef1b36f to c661cba Compare February 23, 2024 11:52
@anhmolt
Copy link
Collaborator Author

anhmolt commented Mar 7, 2024

Closing this and opening a PR directly to nrfconnect/sdk-nrfxlib. nrfconnect#1254

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants