Added a name only constructor to ComLogger #1983

kubiak-jpl · 2023-04-24T19:53:15Z


*Originating Project/Creator*	@kubiak-jpl
*Affected Component*	ComLogger
*Affected Architectures(s)*	N/A
*Related Issue(s)*	N/A
*Has Unit Tests (y/n)*	y
*Builds Without Errors (y/n)*	y
*Unit Tests Pass (y/n)*	y
*Documentation Included (y/n)*	n

Change Description

Updated ComLogger to include a name-only constructor and an additional initialization method

ComLogger(const char* compName);

      // filePrefix: string to prepend the file name with, ie. "thermal_telemetry"
      // maxFileSize: the maximum size a file should reach before being closed and a new one opened
      // storeBufferLength: if true, store the length of each com buffer before storing the buffer itself,
      //                    otherwise just store the com buffer. false might be advantageous in a system
      //                    where you can ensure that all buffers given to the ComLogger are the same size
      //                    in which case you do not need the overhead. Or you store an id which you can
      //                    match to an expected size on the ground during post processing.
      void init_log_file(const char* filePrefix, U32 maxFileSize, bool storeBufferLength=true);

Added a new internal state to keep track of initialization. The ComLogger file will not open if init_log_file is not called and a WARNING_LO event will be created. Using the old constructor sets this state to initialized by default

Added unit tests to cover the new constructor.

Rationale

The name-only constructor is necessary to use ComLogger without the need for phases in the topology fpp.

Testing/Review Recommendations

Updated unit tests

Future Work

None

Svc/ComLogger/ComLogger.hpp

Svc/ComLogger/ComLogger.cpp

Svc/ComLogger/ComLogger.hpp

Svc/ComLogger/ComLogger.cpp

+  void ComLogger ::
+    init_log_file(const char* incomingFilePrefix, U32 maxFileSize, bool storeBufferLength)
+  {
+    this->maxFileSize = maxFileSize;


Svc/ComLogger/ComLogger.cpp

+    init_log_file(const char* incomingFilePrefix, U32 maxFileSize, bool storeBufferLength)
+  {
+    this->maxFileSize = maxFileSize;
+    this->storeBufferLength = storeBufferLength;


Svc/ComLogger/ComLogger.cpp

LeStarch

Minor comments, but looks correct!

Svc/ComLogger/ComLogger.cpp

@@ -49,6 +67,25 @@
    ComLoggerComponentBase::init(queueDepth, instance);
  }

+  void ComLogger ::
+    init_log_file(const char* incomingFilePrefix, U32 maxFileSize, bool storeBufferLength)


Svc/ComLogger/ComLogger.cpp

@@ -49,6 +67,25 @@
    ComLoggerComponentBase::init(queueDepth, instance);
  }

+  void ComLogger ::
+    init_log_file(const char* incomingFilePrefix, U32 maxFileSize, bool storeBufferLength)


Svc/ComLogger/ComLogger.cpp

+  void ComLogger ::
+    init_log_file(const char* incomingFilePrefix, U32 maxFileSize, bool storeBufferLength)


LeStarch · 2023-05-11T00:02:51Z

@kubiak-jpl this looks good. I did three things:

Initialized the other missing variables
added a not-null assert
From the with-arguments constructor, I delegated to your new init function to prevent code duplication.

If you are ok with this, we can merge!

Svc/ComLogger/ComLogger.cpp

-    }
-    FW_ASSERT(Fw::StringUtils::string_length(incomingFilePrefix, sizeof(this->filePrefix)) < sizeof(this->filePrefix),
-      Fw::StringUtils::string_length(incomingFilePrefix, sizeof(this->filePrefix)), sizeof(this->filePrefix)); // ensure that file prefix is not too big
+    this->init_log_file(incomingFilePrefix, maxFileSize, storeBufferLength);


Svc/ComLogger/ComLogger.cpp

-    }
-    FW_ASSERT(Fw::StringUtils::string_length(incomingFilePrefix, sizeof(this->filePrefix)) < sizeof(this->filePrefix),
-      Fw::StringUtils::string_length(incomingFilePrefix, sizeof(this->filePrefix)), sizeof(this->filePrefix)); // ensure that file prefix is not too big
+    this->init_log_file(incomingFilePrefix, maxFileSize, storeBufferLength);


Svc/ComLogger/ComLogger.cpp

-    }
-    FW_ASSERT(Fw::StringUtils::string_length(incomingFilePrefix, sizeof(this->filePrefix)) < sizeof(this->filePrefix),
-      Fw::StringUtils::string_length(incomingFilePrefix, sizeof(this->filePrefix)), sizeof(this->filePrefix)); // ensure that file prefix is not too big
+    this->init_log_file(incomingFilePrefix, maxFileSize, storeBufferLength);


kubiak-jpl · 2023-05-11T15:22:49Z

@kubiak-jpl this looks good. I did three things:

Initialized the other missing variables

added a not-null assert

From the with-arguments constructor, I delegated to your new init function to prevent code duplication.

If you are ok with this, we can merge!

Looks good to me

LeStarch · 2023-05-16T16:55:16Z

@kubiak-jpl merged!

* Added a name only constructor to ComLogger * Minor fixup of CodeQL warnings * Fixing ctor warnings, checking arg * Reusing init_log_file in constructor * sp * NULL -> nullptr * Adding throttle --------- Co-authored-by: M Starch <LeStarch@googlemail.com>

This reverts commit d075381.

Added a name only constructor to ComLogger

b45293b