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

Add Open Port Request on Sending Side of IpSocket #2683

Open
wants to merge 10 commits into
base: devel
Choose a base branch
from

Conversation

csmith608
Copy link
Collaborator

@csmith608 csmith608 commented Apr 16, 2024

Related Issue(s) #2553
Has Unit Tests (y/n) y
Documentation Included (y/n) n

Change Description

Update IpSocket to check socket state on sending side and open socket if necessary

Rationale

This fixes a bug encountered while using IpSocket. The server would close the TCP connection and then the client would try to send and fail because previously IpSocket would only re-open a TCP connection when it received over the socket.

Testing/Review Recommendations

In my project's version of fprime we diverged at fprime 3.0. I added implementations for the close() port in the TcpClient, TcpServer, and Udp as well as unit tests. This change also fixed the issue we were seeing with sending data, but the socket not being there.
This does not include the unit tests or implementations for close() in the ByteStreamDriverModel because I wanted to at least get this part of the change in. I'll work on adding them.
I also ended up commenting out line 85 of Drv/Ip/SocketReadTask.cpp because when I was running other testing without the TCP server, I was being spammed with that logger message.

Future Work

Adding implementations for close() to TcpClient, TcpServer, and Udp as well as unit tests.

(Pipeline failed on "spammed" but I stand behind my spelling, but perhaps not that comment)

Drv/Ip/SocketReadTask.cpp Fixed Show fixed Hide fixed
Drv/Ip/IpSocket.cpp Fixed Show fixed Hide fixed
Drv/Ip/SocketReadTask.cpp Fixed Show fixed Hide fixed
@LeStarch
Copy link
Collaborator

Looks like it passed CI. We'll need to correct spelling. Your spelling is right, so we need to add the word to the expect list.

@LeStarch
Copy link
Collaborator

The list is at: .github/actions/spelling/expect.txt. Just place "spammed" in there is mostly alphabetical order. I can help this afternoon, but the above shows you how to should you get to it sooner.

@LeStarch
Copy link
Collaborator

Fixed the spelling issue. Will review now.

@LeStarch LeStarch self-requested a review April 16, 2024 23:14
Copy link
Collaborator

@LeStarch LeStarch left a comment

Choose a reason for hiding this comment

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

Well I feel dumb, these comments were left as pending for several weeks.

// Open a network connection if it has not already been open
disconnected = false;
// Lock mutex to avoid competing opens from other threads
self->getSocketHandler().lockSocketMutex();
Copy link
Collaborator

Choose a reason for hiding this comment

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

While this code block looks right, I believe it needs to be below (after start-up). I think a start-up needs to be added to to send too (following the same pattern).

Copy link
Collaborator

Choose a reason for hiding this comment

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

Line 98 of your file contains the original open that we should replace with this code

Drv/Ip/SocketReadTask.cpp Fixed Show fixed Hide fixed
@csmith608
Copy link
Collaborator Author

@LeStarch I added a unit test to TcpClient and TcpServer to show the socket auto opening, so I think this should be okay to merge (if it passes the checks).

Drv/Ip/SocketReadTask.cpp Fixed Show fixed Hide fixed
@thomas-bc thomas-bc requested a review from LeStarch July 17, 2024 22:56
@csmith608
Copy link
Collaborator Author

Better way of doing this:

  • Have an active component with one thread that processes events
  • Events are send events that come from outside
  • Another thread is blocking on input that sends the receive events
  • If a send event is processed and the socket isn't open, it opens
  • If on a receive the socket isn't open it opens
  • All mediated by a queue
  • One thread is from the active TCP*Impl.cpp and the receive thread

crsmith added 2 commits August 30, 2024 13:04
…oved behavior to the component level by placing thread protection behavior to SocketReadTask, now called SocketComponentHelper. Calls to socket functionality from TcpClient/TcpServer/Udp will go through SocketComponentHelper rather than directly to the library. This also implemented the original desired functionality of reopening a client socket on a send call rather than only in receive
}
// As long as not told to stop, and we are successful interrupted or ordered to retry, keep receiving
while (not self->m_stop &&
(status == SOCK_SUCCESS || status == SOCK_INTERRUPTED_TRY_AGAIN || self->m_reconnect));

Check warning

Code scanning / CppCheck

Empty loop bodies should use {} or continue Warning

Empty loop bodies should use {} or continue
Copy link

@github-advanced-security github-advanced-security bot left a comment

Choose a reason for hiding this comment

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

CodeQL found more than 20 potential problems in the proposed changes. Check the Files changed tab for more details.

crsmith added 3 commits September 4, 2024 15:31
…tests whos name includes more than the module name
…buffer equality check would fail because the size of the original buffer (owned by the unit test) gets set to 0, sometimes. Maybe 1/10 runs. I changed it to save the size of that buffer before it does the send and use that saved value in the equality check
Drv/Ip/SocketComponentHelper.cpp Fixed Show fixed Hide fixed
Drv/Ip/SocketComponentHelper.cpp Fixed Show fixed Hide fixed
return status;
}

SocketIpStatus IpSocket::send(const U8* const data, const U32 size) {
SocketIpStatus IpSocket::send(NATIVE_INT_TYPE fd, const U8* const data, const U32 size) {

Check notice

Code scanning / CodeQL

Long function without assertion Note

All functions of more than 10 lines should have at least one assertion.
@@ -205,27 +160,19 @@
return SOCK_SUCCESS;
}

SocketIpStatus IpSocket::recv(U8* data, U32& req_read) {
SocketIpStatus IpSocket::recv(NATIVE_INT_TYPE fd, U8* data, U32& req_read) {

Check notice

Code scanning / CodeQL

Long function without assertion Note

All functions of more than 10 lines should have at least one assertion.

namespace Drv {

SocketComponentHelper::SocketComponentHelper() : m_fd(-1), m_reconnect(false), m_stop(false), m_started(false), m_open(false) {}

Check notice

Code scanning / CodeQL

More than one statement per line Note

This line contains 2 statements; only one is allowed.

SocketComponentHelper::SocketComponentHelper() : m_fd(-1), m_reconnect(false), m_stop(false), m_started(false), m_open(false) {}

SocketComponentHelper::~SocketComponentHelper() {}

Check notice

Code scanning / CodeQL

More than one statement per line Note

This line contains 2 statements; only one is allowed.

SocketComponentHelper::~SocketComponentHelper() {}

void SocketComponentHelper::start(const Fw::StringBase &name,

Check notice

Code scanning / CodeQL

Long function without assertion Note

All functions of more than 10 lines should have at least one assertion.
this->shutdown(); // Break out of any receives and fully shutdown
}

SocketIpStatus SocketComponentHelper::recv(U8* data, U32 &size) {

Check notice

Code scanning / CodeQL

Long function without assertion Note

All functions of more than 10 lines should have at least one assertion.
return status;
}

void SocketComponentHelper::readTask(void* pointer) {

Check notice

Code scanning / CodeQL

Long function without assertion Note

All functions of more than 10 lines should have at least one assertion.
@@ -24,7 +24,7 @@

TcpClientComponentImpl::TcpClientComponentImpl(const char* const compName)
: TcpClientComponentBase(compName),
SocketReadTask() {}
SocketComponentHelper() {}

Check notice

Code scanning / CodeQL

More than one statement per line Note

This line contains 2 statements; only one is allowed.
@@ -22,13 +22,14 @@

TcpServerComponentImpl::TcpServerComponentImpl(const char* const compName)
: TcpServerComponentBase(compName),
SocketReadTask() {}
SocketComponentHelper() {}

Check notice

Code scanning / CodeQL

More than one statement per line Note

This line contains 2 statements; only one is allowed.
@@ -24,16 +24,22 @@

UdpComponentImpl::UdpComponentImpl(const char* const compName)
: UdpComponentBase(compName),
SocketReadTask() {}
SocketComponentHelper() {}

Check notice

Code scanning / CodeQL

More than one statement per line Note

This line contains 2 statements; only one is allowed.
@csmith608
Copy link
Collaborator Author

@LeStarch other than the RPi known issue, I think this PR is ready for review

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.

4 participants