{
  "name": "chown",
  "section": 1,
  "title": "change file owner and group",
  "synopsis": [
    "chown [OPTION]... OWNER[:GROUP] FILE..."
  ],
  "description": "Updates uid/gid metadata on the personal Hyperdrive for paths under the active session home, $HOME, /tmp, and /var/log. System paths are read-only. Non-root may only chgrp on files they own; root (euid 0) may set any owner.",
  "options": [],
  "keywords": [
    "chown",
    "bare-os",
    "coreutils",
    "metadata"
  ],
  "bareOsNotes": "OWNER/GROUP may be numeric ids or root/guest/nobody/current USER/GROUP. See packages/bare-os-booter/lib/vfs.js chown.",
  "examples": [
    {
      "caption": "change group only",
      "code": "chown :guest file.txt"
    },
    {
      "caption": "numeric owner and group",
      "code": "chown 1000:1000 notes.txt"
    }
  ]
}