GCC Code Coverage Report


Directory: ./
File: Os/Posix/Directory.cpp
Date: 2026-09-03 22:12:29
Exec Total Coverage
Lines: 14 41 34.1%
Functions: 3 6 50.0%
Branches: 5 30 16.7%

Line Branch Exec Source
1 // ======================================================================
2 // \title Os/Posix/Directory.cpp
3 // \brief Posix implementation for Os::Directory
4 // ======================================================================
5 #include <sys/stat.h>
6 #include <cerrno>
7 #include <cstring>
8
9 #include <Fw/Types/Assert.hpp>
10 #include <Fw/Types/StringUtils.hpp>
11 #include <Os/Posix/Directory.hpp>
12 #include <Os/Posix/error.hpp>
13
14 namespace Os {
15 namespace Posix {
16 namespace Directory {
17
18 2 PosixDirectory::PosixDirectory() : Os::DirectoryInterface(), m_handle() {}
19
20 DirectoryHandle* PosixDirectory::getHandle() {
21 return &this->m_handle;
22 }
23
24 1 PosixDirectory::Status PosixDirectory::open(const char* path, OpenMode mode) {
25 1 Status status = Status::OP_OK;
26
27 // If one of the CREATE mode, attempt to create the directory
28
2/4
✓ Branch 0 taken 1 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 1 times.
✗ Branch 3 not taken.
1 if (mode == OpenMode::CREATE_EXCLUSIVE || mode == OpenMode::CREATE_IF_MISSING) {
29
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 1 times.
1 if (::mkdir(path, S_IRWXU) == -1) {
30 status = errno_to_directory_status(errno);
31 // If error is not ALREADY_EXISTS, return the error
32 // If any error and mode CREATE_EXCLUSIVE, return the error
33 // Else, we keep going with OP_OK
34 if (status != Status::ALREADY_EXISTS || mode == OpenMode::CREATE_EXCLUSIVE) {
35 return status;
36 } else {
37 status = Status::OP_OK;
38 }
39 }
40 }
41
42 1 DIR* dir = ::opendir(path);
43
44
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 1 times.
1 if (dir == nullptr) {
45 status = errno_to_directory_status(errno);
46 }
47
48 1 this->m_handle.m_dir_descriptor = dir;
49 1 return status;
50 }
51
52 PosixDirectory::Status PosixDirectory::rewind() {
53 Status status = Status::OP_OK;
54 // no errors defined in man page for rewinddir
55 ::rewinddir(this->m_handle.m_dir_descriptor);
56 return status;
57 }
58
59 PosixDirectory::Status PosixDirectory::read(char* fileNameBuffer, FwSizeType bufSize) {
60 FW_ASSERT(fileNameBuffer != nullptr);
61
62 Status status = Status::OP_OK;
63
64 // Set errno to 0 so we know why we exited readdir
65 // This is recommended by the manual pages (man 3 readdir)
66 errno = 0;
67
68 struct dirent* direntData = ::readdir(this->m_handle.m_dir_descriptor);
69 while (direntData != nullptr) {
70 // Skip . and .. directory entries
71 if ((direntData->d_name[0] == '.' and direntData->d_name[1] == '\0') or
72 (direntData->d_name[0] == '.' and direntData->d_name[1] == '.' and direntData->d_name[2] == '\0')) {
73 direntData = ::readdir(this->m_handle.m_dir_descriptor);
74 } else {
75 (void)Fw::StringUtils::string_copy(fileNameBuffer, direntData->d_name, bufSize);
76 break;
77 }
78 }
79 if (direntData == nullptr) {
80 // loop ended because readdir failed, did it error or did we run out of files?
81 if (errno != 0) {
82 // Only error from readdir is EBADF
83 status = Status::BAD_DESCRIPTOR;
84 } else {
85 status = Status::NO_MORE_FILES;
86 }
87 }
88 return status;
89 }
90
91 1 void PosixDirectory::close() {
92 // ::closedir errors if dir descriptor is nullptr
93
1/2
✓ Branch 0 taken 1 times.
✗ Branch 1 not taken.
1 if (this->m_handle.m_dir_descriptor != nullptr) {
94 1 (void)::closedir(this->m_handle.m_dir_descriptor);
95 }
96 1 this->m_handle.m_dir_descriptor = nullptr;
97 1 }
98
99 } // namespace Directory
100 } // namespace Posix
101 } // namespace Os
102