Files
bare-operating-system/packages/bare-os-coreutils/man/pages/chown.json
T
2026-04-03 23:04:42 -04:00

32 lines
1.2 KiB
JSON

{
"name": "chown",
"section": 1,
"title": "change file owner and group",
"synopsis": ["chown [-h] OWNER[:GROUP] FILE...", "chown [-h] :GROUP FILE..."],
"description": "Updates uid/gid and optional user/group names in Hyperdrive metadata on writable paths (personal drive, /tmp, etc.). Not a multi-user host kernel: OWNER and GROUP are limited to numeric ids and the names root, guest, nobody, or the current session USER/GROUP.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage and exit"
}
],
"keywords": ["chown", "bare-os", "coreutils", "metadata"],
"diagnostics": [
"chown: invalid owner or group",
"chown: not supported by this VFS",
"chown: unsupported option"
],
"bareOsNotes": "Requires vfs.chown. Identity is still single-session; use login/logout for Ed25519-backed identity, not arbitrary POSIX users.",
"examples": [
{
"caption": "set numeric owner and group on a file under $HOME",
"code": "chown 1000:1000 ~/notes.txt"
},
{
"caption": "change group only (leading colon), keep owner",
"code": "chown :guest ~/shared.txt"
}
],
"listCategory": "coreutils"
}