Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Honor the requested mode in the Windows access provider

Open Beginner friendly
#705 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
75/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
rust

Research direction

The issue is in the file std/sys/windows/fs.wave. Start by reading the access function in that file to see how it currently ignores the mode parameter. Compare with other platform implementations to understand the expected behavior. Implement the mode checks using Windows API calls (like GetFileAttributes for existence, and perhaps CreateFile with desired access to test readability/writability). Write tests in the same file or a corresponding test module to verify existence (FS_F_OK), readable (FS_R_OK), and non-writable (FS_W_OK on a read-only file) cases. Ensure failures return the correct portable error codes.

Written by the indexing model from the issue text.

Description

bug good first issue os compatibility

Problem

std/sys/windows/fs.wave exposes FS_F_OK, FS_X_OK, FS_W_OK, and FS_R_OK, but access(path, mode) never reads mode. Any existing path therefore succeeds regardless of the requested access check, so a write check currently behaves the same as an existence check.

Other filesystem providers pass the requested mode through to their native access primitive, so the Windows provider does not preserve the portable contract.

Completion criteria

  • Keep FS_F_OK as an existence check.
  • Make nonzero access modes affect the Windows result instead of being ignored.
  • Ensure a read-only file does not report writable for FS_W_OK.
  • Define and test the Windows behavior for the exported FS_R_OK and FS_X_OK modes.
  • Return the existing portable negative error codes on failure.
  • Add focused Windows regression coverage for existence, readable, and non-writable cases.

Difficulty: easy.

Dominant language
Rust
Stars
53
Forks
16
Avg merge
3h 38m
Merged PRs (30d)
48

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from wavefnd/Wave

All issues in wavefnd/Wave

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.