{
    "content": [
        {
            "type": "text",
            "text": "# systemd-fstab-generator(8) (man)\n\n**Summary:** systemd-fstab-generator - Unit generator for /etc/fstab\n\n**Synopsis:** /lib/systemd/system-generators/systemd-fstab-generator\n\n## See Also\n\n- systemd(1)\n- fstab(5)\n- systemd.mount(5)\n- systemd.swap(5)\n- systemd-cryptsetup-generator(8)\n- systemd-gpt-auto-generator(8)\n- kernel-command-line(7)\n- SYSTEMD-FSTAB-GENERATOR(8)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (19 lines)\n- **KERNEL COMMAND LINE** (107 lines)\n- **SEE ALSO** (6 lines)\n\n## Full Content\n\n### NAME\n\nsystemd-fstab-generator - Unit generator for /etc/fstab\n\n### SYNOPSIS\n\n/lib/systemd/system-generators/systemd-fstab-generator\n\n### DESCRIPTION\n\nsystemd-fstab-generator is a generator that translates /etc/fstab (see fstab(5) for details)\ninto native systemd units early at boot and when configuration of the system manager is\nreloaded. This will instantiate mount and swap units as necessary.\n\nThe passno field is treated like a simple boolean, and the ordering information is discarded.\nHowever, if the root file system is checked, it is checked before all the other file systems.\n\nSee systemd.mount(5) and systemd.swap(5) for more information about special /etc/fstab mount\noptions this generator understands.\n\nOne special topic is handling of symbolic links. Historical init implementations supported\nsymlinks in /etc/fstab. Because mount units will refuse mounts where the target is a symbolic\nlink, this generator will resolve any symlinks as far as possible when processing /etc/fstab\nin order to enhance backwards compatibility. If a symlink target does not exist at the time\nthat this generator runs, it is assumed that the symlink target is the final target of the\nmount.\n\nsystemd-fstab-generator implements systemd.generator(7).\n\n### KERNEL COMMAND LINE\n\nsystemd-fstab-generator understands the following kernel command line parameters:\n\nfstab=, rd.fstab=\nTakes a boolean argument. Defaults to \"yes\". If \"no\", causes the generator to ignore any\nmounts or swap devices configured in /etc/fstab.  rd.fstab= is honored only by the\ninitial RAM disk (initrd) while fstab= is honored by both the main system and the initrd.\n\nroot=\nConfigures the operating system's root filesystem to mount when running in the initrd.\nThis accepts a device node path (usually /dev/disk/by-uuid/...  or /dev/disk/by-label/...\nor similar), or the special values \"gpt-auto\" and \"tmpfs\".\n\nUse \"gpt-auto\" to explicitly request automatic root file system discovery via systemd-\ngpt-auto-generator(8).\n\nUse \"tmpfs\" in order to mount a tmpfs(5) file system as root file system of the OS. This\nis useful in combination with mount.usr= (see below) in order to combine a volatile root\nfile system with a separate, immutable /usr/ file system. Also see systemd.volatile=\nbelow.\n\nrootfstype=\nTakes the root filesystem type that will be passed to the mount command.  rootfstype= is\nhonored by the initrd.\n\nrootflags=\nTakes the root filesystem mount options to use.  rootflags= is honored by the initrd.\n\nNote that unlike most kernel command line options this setting does not override settings\nmade in configuration files (specifically: the mount option string in /etc/fstab). See\nsystemd-remount-fs.service(8).\n\nmount.usr=\nTakes the /usr/ filesystem to be mounted by the initrd. If mount.usrfstype= or\nmount.usrflags= is set, then mount.usr= will default to the value set in root=.\n\nOtherwise, this parameter defaults to the /usr/ entry found in /etc/fstab on the root\nfilesystem.\n\nmount.usr= is honored by the initrd.\n\nmount.usrfstype=\nTakes the /usr/ filesystem type that will be passed to the mount command. If mount.usr=\nor mount.usrflags= is set, then mount.usrfstype= will default to the value set in\nrootfstype=.\n\nOtherwise, this value will be read from the /usr/ entry in /etc/fstab on the root\nfilesystem.\n\nmount.usrfstype= is honored by the initrd.\n\nmount.usrflags=\nTakes the /usr/ filesystem mount options to use. If mount.usr= or mount.usrfstype= is\nset, then mount.usrflags= will default to the value set in rootflags=.\n\nOtherwise, this value will be read from the /usr/ entry in /etc/fstab on the root\nfilesystem.\n\nmount.usrflags= is honored by the initrd.\n\nsystemd.volatile=\nControls whether the system shall boot up in volatile mode. Takes a boolean argument or\nthe special value state.\n\nIf false (the default), this generator makes no changes to the mount tree and the system\nis booted up in normal mode.\n\nIf true the generator ensures systemd-volatile-root.service(8) is run as part of the\ninitial RAM disk (\"initrd\"). This service changes the mount table before transitioning to\nthe host system, so that a volatile memory file system (\"tmpfs\") is used as root\ndirectory, with only /usr/ mounted into it from the configured root file system, in\nread-only mode. This way the system operates in fully stateless mode, with all\nconfiguration and state reset at boot and lost at shutdown, as /etc/ and /var/ will be\nserved from the (initially unpopulated) volatile memory file system.\n\nIf set to state the generator will leave the root directory mount point unaltered,\nhowever will mount a \"tmpfs\" file system to /var/. In this mode the normal system\nconfiguration (i.e. the contents of \"/etc/\") is in effect (and may be modified during\nsystem runtime), however the system state (i.e. the contents of \"/var/\") is reset at boot\nand lost at shutdown.\n\nIf this setting is set to \"overlay\" the root file system is set up as \"overlayfs\" mount\ncombining the read-only root directory with a writable \"tmpfs\", so that no modifications\nare made to disk, but the file system may be modified nonetheless with all changes being\nlost at reboot.\n\nNote that in none of these modes the root directory, /etc/, /var/ or any other resources\nstored in the root file system are physically removed. It's thus safe to boot a system\nthat is normally operated in non-volatile mode temporarily into volatile mode, without\nlosing data.\n\nNote that with the exception of \"overlay\" mode, enabling this setting will only work\ncorrectly on operating systems that can boot up with only /usr/ mounted, and are able to\nautomatically populate /etc/, and also /var/ in case of \"systemd.volatile=yes\".\n\nAlso see root=tmpfs above, for a method to combine a \"tmpfs\" file system with a regular\n/usr/ file system (as configured via mount.usr=). The main distinction between\nsystemd.volatile=yes, and root=tmpfs in combination mount.usr= is that the former\noperates on top of a regular root file system and temporarily obstructs the files and\ndirectories above its /usr/ subdirectory, while the latter does not hide any files, but\nsimply mounts a unpopulated tmpfs as root file system and combines it with a user picked\n/usr/ file system.\n\nsystemd.swap\nTakes a boolean argument or enables the option if specified without an argument. If\ndisabled, causes the generator to ignore any swap devices configured in /etc/fstab.\nDefaults to enabled.\n\n### SEE ALSO\n\nsystemd(1), fstab(5), systemd.mount(5), systemd.swap(5), systemd-cryptsetup-generator(8),\nsystemd-gpt-auto-generator(8), kernel-command-line(7)\n\n\n\nsystemd 249                                                               SYSTEMD-FSTAB-GENERATOR(8)\n\n"
        }
    ],
    "structuredContent": {
        "command": "systemd-fstab-generator",
        "section": "8",
        "mode": "man",
        "summary": "systemd-fstab-generator - Unit generator for /etc/fstab",
        "synopsis": "/lib/systemd/system-generators/systemd-fstab-generator",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [
            {
                "name": "systemd",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/systemd/1/json"
            },
            {
                "name": "fstab",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/fstab/5/json"
            },
            {
                "name": "systemd.mount",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/systemd.mount/5/json"
            },
            {
                "name": "systemd.swap",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/systemd.swap/5/json"
            },
            {
                "name": "systemd-cryptsetup-generator",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/systemd-cryptsetup-generator/8/json"
            },
            {
                "name": "systemd-gpt-auto-generator",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/systemd-gpt-auto-generator/8/json"
            },
            {
                "name": "kernel-command-line",
                "section": "7",
                "url": "https://www.chedong.com/phpMan.php/man/kernel-command-line/7/json"
            },
            {
                "name": "SYSTEMD-FSTAB-GENERATOR",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/SYSTEMD-FSTAB-GENERATOR/8/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 19,
                "subsections": []
            },
            {
                "name": "KERNEL COMMAND LINE",
                "lines": 107,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 6,
                "subsections": []
            }
        ]
    }
}