{
  "name": "chmod",
  "section": 1,
  "title": "change file mode bits",
  "synopsis": [
    "chmod MODE FILE...",
    "MODE is octal (e.g. 644) or symbolic (e.g. u+rw)"
  ],
  "description": "Sets file mode bits on the VFS. Supports POSIX-style symbolic modes (u/g/o/a, +/-/=, rwxX) and octal modes.",
  "options": [],
  "keywords": [
    "chmod",
    "mode",
    "permission",
    "octal",
    "symbolic"
  ],
  "diagnostics": [
    "chmod: No such file",
    "chmod: invalid mode"
  ],
  "bareOsNotes": "Applies to Hyperdrive metadata; not a host inode.",
  "examples": [
    {
      "caption": "octal",
      "code": "chmod 644 ~/.profile"
    },
    {
      "caption": "recursive-ish (run find + chmod per file)",
      "code": "find . -type f -name \"*.sh\" -print"
    },
    {
      "caption": "symbolic user bits",
      "code": "chmod u+x script.sh"
    },
    {
      "caption": "all read, owner write",
      "code": "chmod a+r,u+w shared.txt"
    }
  ]
}