{
  "name": "mkdir",
  "section": 1,
  "title": "make directories",
  "synopsis": ["mkdir [OPTION]... DIRECTORY..."],
  "description": "Creates directories using the VFS marker convention. **`-m MODE`** sets permission bits (octal) on **`.bareos_empty`**; **`lstat`** on the directory reports **`S_IFDIR`** with those bits (execute bits are implied for user/group/other when the corresponding read bit is set, so traversal still works).",
  "options": [
    { "flag": "-p, --parents", "meaning": "Create parent directories as needed." },
    { "flag": "-m MODE", "meaning": "Directory mode (octal, e.g. **755** or **0755**)." }
  ],
  "keywords": ["mkdir", "bare-os", "coreutils"],
  "examples": [
    { "caption": "one dir", "code": "mkdir proj" },
    { "caption": "parents", "code": "mkdir -p a/b/c" },
    { "caption": "mode", "code": "mkdir -m 700 private" }
  ]
}