{
  "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"
}