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

Discovered a lot of minor problems after running static code analysis #33

Closed
db-tech opened this issue Jun 7, 2021 · 11 comments
Closed
Labels
dev Developing uvgRTP is easier, but these features are not visible to users of the library

Comments

@db-tech
Copy link

db-tech commented Jun 7, 2021

I did check the source with a static code analyzer and found lots of maybe minor problems that should be resolved.

Just to show some examples

condition is always false

uint32_t intra = INVALID_TS;            

if (intra != INVALID_TS && enable_idelay) {
__drop_frame(finfo, intra);
    finfo->dropped.insert(intra);
}

unreachable code

if (more) {
    aggr_pkt_info_.nalus.push_back(std::make_pair(data_len, data));
    return RTP_NOT_READY;
} else {
....
     if (more)
        return RTP_NOT_READY;
....
}

Also there are a lot of those checks:

    if (frame->csrc)
        delete[] frame->csrc;

It by no means critical, but could be changed easily and therefore make it more readable.

Those are just examples, there is a lot more stuff.
I guess those could be done in one bigger PR...

@jrsnen
Copy link
Member

jrsnen commented Jun 7, 2021

I sometimes write similar code to this. The point for me is that even though the if is always false now, you never know how the code will change later and suddenly the frame csrc can be invalid. This makes the code less prone to have bugs. This code could use more debug prints though to indicate that something went wrong and still work. This way it does not immediately become show stopper while alerting the dev that there is a problem.

This is just my way of coding things and I'm not sure if @altonen had the same idea or what.

I'm not sure all of the if:s are needed, but hard to say without specific list. The middle one seems unnecessary to me.

Which analysis tool did you use? Can you paste the output?

@db-tech
Copy link
Author

db-tech commented Jun 7, 2021

The point for me is that even though the if is always false now, you never know how the code will change later and suddenly the frame csrc can be invalid

I expect you refer to the third example ? Not sure what you mean by "invalid". It is totally save to delete an nullptr, so there would be no need to check for it.
The only check that would make sense in my mind, would be to delete a pointer that was already deleted (that is not nullptr). But this check would not prevent it. But I might of course just miss something here.

Which analysis tool did you use? Can you paste the output?

I've used just the integration in Clion which uses Clang-tidy. I cannot paste the output, that would be way to much and not everything is really sensible. But I could embed a analyzing target into the CMake file.
I wanted to change some stuff in a PR for #13 anyway as soon as #12 is closed.

@jrsnen
Copy link
Member

jrsnen commented Jun 8, 2021

I've been thinking about this and maybe what I meant was that checking pointers and values that come from outside the function is important, but if the value is set inside the same function then I see no sense in checking it. I'm not very familiar on what types of issues the code analyzer recognizes.

I have seen a lot of the C way, where variables are created at the start of the function, whereas I like to create them as close to their usage as possible (and initialize them for sure). This might be part of the problem and would like it changed at some point.

I would also like @altonen's opinion on the purpose of these checks.

@altonen
Copy link
Collaborator

altonen commented Jun 8, 2021

The first example I don't understand. I took a quick look at the code and I see that intra given a value and flags parameter (which the caller of uvgRTP controls) is used to determine whether late intras are dropped or not. I don't know why the analyzer says that the condition is always false, it's not at least immediately apparent after reading the code.

The second code example is a result of some refactoring, the second check for more obviously shouldn't be there.

I have no recollection of writing that CSRC check code so I cannot comment on why the value is checked before it's released. But it can be removed of course.

@db-tech
Copy link
Author

db-tech commented Jun 8, 2021

The first example I don't understand

This is because in the file h265_pkt_handler.cc in function packet_handler the variable intra will initially get the value INVALID_TS and never get the chance to change. So intra != INVALID_TS can never be true.
The analyzer warns about this because this indicates that something could be wrong here. And I agree, looks strange to me to.

@jrsnen
Copy link
Member

jrsnen commented Jun 8, 2021

@db-tech you can make a PR if you want. If there are some checks that seem like they should be there, I can add them back afterwards. It doesn't sound like there would be many if any.

Seems like this invalid intra is a separate issue.

@db-tech
Copy link
Author

db-tech commented Jun 8, 2021

K, I will create a PR as soon as I find the time.

@db-tech
Copy link
Author

db-tech commented Jun 10, 2021

There are a lot of function with double underscore in the name, the standard states:

the identifiers with a double underscore anywhere are reserved;

I am, personally not fond of them either :-)
Would it be ok to rename those? If so, any preferences besides just removing the underscores ?

@db-tech
Copy link
Author

db-tech commented Jun 10, 2021

Sorry, I have to give up. It is just to much stuff that I cannot simply change without asking you first.
So it does not make sense for me to address those.

I would suggest that you do some static code analysis yourself and go over file by file to change the problems in one big sweep.
Because it's your code, you will be much faster then I would be.

I could offer you a pair programming session where we discuss some stuff live.
I could also build an analysis into the cmake file, then I would need an answer to this question:
#38 (comment)

@jrsnen
Copy link
Member

jrsnen commented Jun 11, 2021

Understandable. I realized that I have been naturally running IntelliSense with msvc compilations. I also tried Clang-tidy through Qt Creator which gives slightly different results.

I have gotten a lot of warnings that I think should be addressed (I already tried addressing type conversions), but not these ones mentioned in this issue. Qt creator does offers more options for tidy that can be enabled so maybe that is the reason.

I think prefix underscores should definitely be removed. They seem to exist with local functions, so maybe an underscore afterwards or adding word local to function beginning would be a good alternative.

I'm new to this project as well, so it will take some time to establish a new style guide (with c++ stuff and more secure code base). I will create a new issue when I start working on this and will warmly welcome everyone to participate in the discussion. Some sort of meeting or two could be organized once the first draft has been formulated.

Adding analysis into CMake file would not be a bad idea.

@jrsnen jrsnen added the dev Developing uvgRTP is easier, but these features are not visible to users of the library label Jul 14, 2021
@jrsnen
Copy link
Member

jrsnen commented Sep 2, 2022

I removed most compiler warnings on MSVC (expect class enum) and all warnings on Linux. I also run the Clang static analyzer and fixed issues it pointed out in its report.

I'm not super experienced with static analyzers, but I fixed all warnings I could get my hands on, so I will consider this issue solved. If there is a specific tool that should be run, anyone can suggest it by opening a new issue.

@jrsnen jrsnen closed this as completed Sep 2, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dev Developing uvgRTP is easier, but these features are not visible to users of the library
Projects
None yet
Development

No branches or pull requests

3 participants