Skip to content

docs: document udev dependency for /dev/disk/by-uuid links - #456

Merged
ebiggers merged 2 commits into
google:masterfrom
amarkdotdev:docs/55-udev-dependency
Aug 22, 2026
Merged

docs: document udev dependency for /dev/disk/by-uuid links#456
ebiggers merged 2 commits into
google:masterfrom
amarkdotdev:docs/55-udev-dependency

Conversation

@amarkdotdev

Copy link
Copy Markdown
Contributor

Summary

  • Document that cross-filesystem UUID links depend on /dev/disk/by-uuid and the standard 60-persistent-storage.rules udev rule.
  • Clarify this is a runtime / link-creation dependency (not build-time), including path fallback behavior.

Fixes #55

Notes

  • Contributor will sign the Google CLA if required for this repository.

Test plan

  • Review the new Runtime dependencies subsection in README.md for accuracy

Explain that cross-filesystem UUID links depend on
60-persistent-storage.rules at link-creation and runtime, with path
fallback when UUID lookup is unavailable.

Signed-off-by: amarkdotdev <amarkdotdev@users.noreply.github.com>
Comment thread README.md Outdated
still create `/dev/disk/by-uuid/*` symlinks before relying on UUID-based
cross-filesystem links. Example upstream sources:

* [systemd `60-persistent-storage.rules`](https://github.com/systemd/systemd/blob/master/rules.d/60-persistent-storage.rules)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

This link doesn't work.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

swapped it for a working link

Comment thread README.md Outdated
cross-filesystem links. Example upstream sources:

* [systemd `60-persistent-storage.rules`](https://github.com/systemd/systemd/blob/master/rules.d/60-persistent-storage.rules)
* [eudev `60-persistent-storage.rules`](https://github.com/gentoo/eudev/blob/master/rules/60-persistent-storage.rules)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

This one does work, but it redirects to a new location. Best to link directly to the new location.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

pointed at the dest instead of the redirect

Signed-off-by: Aaron <amark@g.jct.ac.il>
@ebiggers
ebiggers merged commit 8c97b5d into google:master Aug 22, 2026
6 checks passed
@ebiggers

Copy link
Copy Markdown
Collaborator

Merged, thanks.

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.

Document exact specifics of udev dependancy

2 participants