Bug 292231 - diskless(8) man page mentions obsolete script
Summary: diskless(8) man page mentions obsolete script
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-bugs (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2026-01-06 22:05 UTC by elephant
Modified: 2026-06-30 15:35 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description elephant 2026-01-06 22:05:36 UTC
The following line mentions a script that no longer exists in freebsd-src.

"The script /usr/share/examples/diskless/clone_root can help in creating it,
using the server's root partition as a reference."
Comment 1 elephant 2026-01-06 22:15:27 UTC
Script retired here:
https://github.com/freebsd/freebsd-src/commit/7736786b08e8c9edb07088db3229695d0afed600

Looks like handbook was updated.
Comment 2 elephant 2026-01-06 22:19:08 UTC
Just verifying it is still present in 15.0-RELEASE.

https://man.freebsd.org/cgi/man.cgi?query=diskless&sektion=8&format=html
Comment 3 elephant 2026-01-06 22:23:58 UTC
Ran this to confirm no other references
$ find . -name '*.gz' -print0 | xargs -0 zgrep 'clone_root'
Comment 4 Alexander Ziaee freebsd_committer freebsd_triage 2026-01-06 22:39:48 UTC
Yes, this manual is almost as old as I am. I knew it was stale when I updated the search keywords to make it more discoverable. There's a lot of good truth here. It needs to be rewritten for rc.initdiskless, but I'm not really familiar with it to do that.
Comment 5 commit-hook freebsd_committer freebsd_triage 2026-06-10 12:36:27 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=f8c8875add6946b09ea8cf1f7bbdbd90fe5b1f17

commit f8c8875add6946b09ea8cf1f7bbdbd90fe5b1f17
Author:     Kit Dallege <xaum.io@gmail.com>
AuthorDate: 2026-03-27 04:25:41 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2026-06-10 12:35:04 +0000

    diskless(8): remove references to deleted clone_root script

    The clone_root script was removed from the tree in commit
    7736786b08e8 but the diskless(8) man page still referenced it
    in two places. Remove both references.

    PR: 292231
    Signed-off-by: Kit Dallege <xaum.io@gmail.com>
    Reviewed by: imp
    Pull Request: https://github.com/freebsd/freebsd-src/pull/2101

 share/man/man8/diskless.8 | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)
Comment 6 commit-hook freebsd_committer freebsd_triage 2026-06-30 15:35:59 UTC
A commit in branch stable/15 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=6ed2f5184251bc021976cf5b25696716cf09cf5c

commit 6ed2f5184251bc021976cf5b25696716cf09cf5c
Author:     Kit Dallege <xaum.io@gmail.com>
AuthorDate: 2026-03-27 04:25:41 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2026-06-30 15:35:04 +0000

    diskless(8): remove references to deleted clone_root script

    The clone_root script was removed from the tree in commit
    7736786b08e8 but the diskless(8) man page still referenced it
    in two places. Remove both references.

    PR: 292231
    Signed-off-by: Kit Dallege <xaum.io@gmail.com>
    Reviewed by: imp
    Pull Request: https://github.com/freebsd/freebsd-src/pull/2101
    (cherry picked from commit f8c8875add6946b09ea8cf1f7bbdbd90fe5b1f17)

 share/man/man8/diskless.8 | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)