Skip to content

Add codebase mapping documentation#255

Closed
ruck314 wants to merge 3 commits intopre-releasefrom
gsd_map-codebase
Closed

Add codebase mapping documentation#255
ruck314 wants to merge 3 commits intopre-releasefrom
gsd_map-codebase

Conversation

@ruck314
Copy link
Copy Markdown
Contributor

@ruck314 ruck314 commented Mar 25, 2026

Summary

Creates structured codebase documentation including:

  • Technology stack (C/C++/CUDA, kernel drivers, build systems)
  • Architecture and directory structure
  • Code conventions and testing strategy
  • Known concerns and open questions

Test plan

  • Codebase map documents written by mapper agents
  • Documents committed and pushed to branch
  • Review and merge to pre-release

ruck314 added 2 commits March 24, 2026 14:32
Creates structured documentation for the codebase state including:
- Technology stack and integrations
- Architecture and directory structure
- Code conventions and testing strategy
- Known concerns and open questions
@ruck314 ruck314 requested a review from JJL772 March 25, 2026 18:11
Copy link
Copy Markdown
Member

@JJL772 JJL772 left a comment

Choose a reason for hiding this comment

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

A few comments on the reported problems list

Update CONCERNS.md to incorporate developer feedback:
- Race condition in Dma_SetMaskBytes downgraded (only relevant with concurrent callers)
- User pointer validation corrected (copy_from_user/copy_to_user handle inaccessible pages)
- RHEL_RELEASE_VERSION usage clarified as intentional (RedHat backports make LINUX_VERSION_CODE unreliable)
- Memory barrier concern moved to low-priority audit item (writel/readl are sequentially ordered)
- New: AxisG2_WriteTx continue flag silently dropped (= vs |= bug)
- New: World-writable device nodes (0666)
- New: Yocto vendored source copies may diverge from common/driver/

Refresh all other documents (STACK, INTEGRATIONS, ARCHITECTURE, STRUCTURE, CONVENTIONS, TESTING)
with updated analysis date 2026-03-26 and expanded detail.
@ruck314
Copy link
Copy Markdown
Contributor Author

ruck314 commented Mar 27, 2026

After working on other project, I don't think we should commit the .planning stuff. I will close this PR

@ruck314 ruck314 closed this Mar 27, 2026
@ruck314 ruck314 deleted the gsd_map-codebase branch March 27, 2026 21:43
@JJL772
Copy link
Copy Markdown
Member

JJL772 commented Mar 27, 2026

Could probably put it on confluence or something.

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.

2 participants