{
  "name": "chgrp",
  "section": 1,
  "title": "change file group ownership",
  "synopsis": ["chgrp [-h] GROUP FILE..."],
  "description": "Sets the group id (and optional group name) in Hyperdrive metadata on writable paths. GROUP may be a numeric gid or the name root, guest, nobody, or the current session GROUP.",
  "options": [
    {
      "flag": "-h, --help",
      "meaning": "Print usage and exit"
    }
  ],
  "keywords": ["chgrp", "bare-os", "coreutils", "metadata"],
  "diagnostics": [
    "chgrp: invalid group",
    "chgrp: not supported by this VFS",
    "chgrp: unsupported option"
  ],
  "bareOsNotes": "Same writable scope as chmod; gid is stored for display and permission checks, not a real multi-user group database.",
  "examples": [
    {
      "caption": "set group by numeric gid",
      "code": "chgrp 1000 ~/data/file"
    },
    {
      "caption": "set group to current session group name",
      "code": "chgrp guest ~/tmp/file"
    }
  ],
  "listCategory": "coreutils"
}