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

[PATCH v4] api: std: clarify odp_bool_t documentation #2077

Merged
merged 3 commits into from
Sep 6, 2024

Conversation

MatiasElo
Copy link
Collaborator

No description provided.

@odpbuild odpbuild changed the title api: std: clarify odp_bool_t documentation [PATCH v1] api: std: clarify odp_bool_t documentation Jun 17, 2024
@@ -22,7 +22,7 @@ extern "C" {
* @{
*/

typedef int odp_bool_t;
typedef bool odp_bool_t;
Copy link
Collaborator

Choose a reason for hiding this comment

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

This is not only for memory savings but to make the behavior comply with the clarified API when 64 bit values are assigned to an odp_bool (otherwise e.g. unsigned values with the low 32 bits zero (like 0x100000000) would get converted to zero). The commit message could mention this.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Commit message improved in V2.

@JannePeltonen
Copy link
Collaborator

With a commit message improvement, Reviewed-by: Janne Peltonen janne.peltonen@nokia.com

@odpbuild odpbuild changed the title [PATCH v1] api: std: clarify odp_bool_t documentation [PATCH v2] api: std: clarify odp_bool_t documentation Jul 8, 2024
@MatiasElo MatiasElo added the API next API change for next release label Jul 19, 2024
@MatiasElo MatiasElo added this to the v1.45.1.0 release milestone Aug 26, 2024
@MatiasElo MatiasElo added API spec OK API specification is ready. Needs implementation and test updates. and removed API next API change for next release labels Aug 28, 2024
@odpbuild odpbuild changed the title [PATCH v2] api: std: clarify odp_bool_t documentation [PATCH v3] api: std: clarify odp_bool_t documentation Sep 5, 2024
@MatiasElo MatiasElo added API Ready API change ready to be merged (with the next API version increment) and removed API spec OK API specification is ready. Needs implementation and test updates. labels Sep 5, 2024
Match pktio_if_ops_t.promisc_mode_set() argument type (odp_bool_t) to the
API function odp_pktio_promisc_mode_set().

Signed-off-by: Matias Elo <matias.elo@nokia.com>
Reviewed-by: Janne Peltonen <janne.peltonen@nokia.com>
Reviewed-by: Petri Savolainen <petri.savolainen@nokia.com>
Improve odp_bool_t documentation by stating how the data type can by used
with standard C booleans and what is considered true/false.

Signed-off-by: Matias Elo <matias.elo@nokia.com>
Reviewed-by: Janne Peltonen <janne.peltonen@nokia.com>
Reviewed-by: Petri Savolainen <petri.savolainen@nokia.com>
Reviewed-by: Jerin Jacob <jerinj@marvell.com>
Change ABI type for odp_bool_t from int to bool to comply with the
clarified API documentation. Otherwise for example unsigned values with all
zero lowest 32 bits (e.g. 0x100000000) would get converted to zero. The
change can also reduce memory usage.

Signed-off-by: Matias Elo <matias.elo@nokia.com>
Reviewed-by: Janne Peltonen <janne.peltonen@nokia.com>
Reviewed-by: Petri Savolainen <petri.savolainen@nokia.com>
@odpbuild odpbuild changed the title [PATCH v3] api: std: clarify odp_bool_t documentation [PATCH v4] api: std: clarify odp_bool_t documentation Sep 6, 2024
@MatiasElo MatiasElo enabled auto-merge (rebase) September 6, 2024 06:44
@MatiasElo MatiasElo merged commit b35d8ca into OpenDataPlane:master Sep 6, 2024
170 checks passed
@MatiasElo MatiasElo deleted the dev/api-bool branch September 6, 2024 09:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
API Ready API change ready to be merged (with the next API version increment)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants