{
    "content": [
        {
            "type": "text",
            "text": "# e4crypt(8) (man)\n\n**Summary:** e4crypt - ext4 file system encryption utility\n\n**Synopsis:** e4crypt addkey -S [ -k keyring ] [-v] [-q] [ -p pad ] [ path ... ]\ne4crypt newsession\ne4crypt getpolicy path ...\ne4crypt setpolicy [ -p pad ] policy path ...\n\n## See Also\n\n- keyctl(1)\n- mke2fs(8)\n- mount(8)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (5 lines)\n- **DESCRIPTION** (2 lines)\n- **COMMANDS** (38 lines)\n- **AUTHOR** (3 lines)\n- **SEE ALSO** (5 lines)\n\n## Full Content\n\n### NAME\n\ne4crypt - ext4 file system encryption utility\n\n### SYNOPSIS\n\ne4crypt addkey -S [ -k keyring ] [-v] [-q] [ -p pad ] [ path ... ]\ne4crypt newsession\ne4crypt getpolicy path ...\ne4crypt setpolicy [ -p pad ] policy path ...\n\n### DESCRIPTION\n\ne4crypt performs encryption management for ext4 file systems.\n\n### COMMANDS\n\ne4crypt addkey [-vq] [-S salt ] [-k keyring ] [ -p pad ] [ path ... ]\nPrompts  the  user  for a passphrase and inserts it into the specified keyring.  If no\nkeyring is specified, e4crypt will use the session keyring if it exists  or  the  user\nsession keyring if it does not.\n\nThe  salt  argument is interpreted in a number of different ways, depending on how its\nprefix value.  If the first two characters are \"s:\", then the  rest  of  the  argument\nwill  be  used as an text string and used as the salt value.  If the first two charac‐\nters are \"0x\", then the rest of the argument will be parsed as a hex string as used as\nthe  salt.  If the first characters are \"f:\" then the rest of the argument will be in‐\nterpreted as a filename from which the salt value will be read.  If the string  begins\nwith  a '/' character, it will similarly be treated as filename.  Finally, if the salt\nargument can be parsed as a valid UUID, then the UUID value will be  used  as  a  salt\nvalue.\n\nThe keyring argument specifies the keyring to which the key should be added.\n\nThe  pad  value  specifies  the  number of bytes of padding will be added to directory\nnames for obfuscation purposes.  Valid pad values are 4, 8, 16, and 32.\n\nIf one or more directory paths are specified, e4crypt will try to set  the  policy  of\nthose directories to use the key just added by the addkey command.  If a salt was ex‐\nplicitly specified, then it will be used to derive the encryption key of those  direc‐\ntories.  Otherwise a directory-specific default salt will be used.\n\ne4crypt getpolicy path ...\nPrint the policy for the directories specified on the command line.\n\ne4crypt newsession\nGive  the  invoking  process (typically a shell) a new session keyring, discarding its\nold session keyring.\n\ne4crypt setpolicy [ -p pad ] policy path ...\nSets the policy for the directories specified on the command  line.   All  directories\nmust  be  empty  to set the policy; if the directory already has a policy established,\ne4crypt will validate that the policy matches what was specified.  A policy is an  en‐\ncryption key identifier consisting of 16 hexadecimal characters.\n\n### AUTHOR\n\nWritten by Michael Halcrow <mhalcrow@google.com>, Ildar Muslukhov <muslukhovi@gmail.com>, and\nTheodore Ts'o <tytso@mit.edu>\n\n### SEE ALSO\n\nkeyctl(1), mke2fs(8), mount(8).\n\n\n\nE2fsprogs version 1.46.5                    December 2021                                 E4CRYPT(8)\n\n"
        }
    ],
    "structuredContent": {
        "command": "e4crypt",
        "section": "8",
        "mode": "man",
        "summary": "e4crypt - ext4 file system encryption utility",
        "synopsis": "e4crypt addkey -S [ -k keyring ] [-v] [-q] [ -p pad ] [ path ... ]\ne4crypt newsession\ne4crypt getpolicy path ...\ne4crypt setpolicy [ -p pad ] policy path ...",
        "flags": [],
        "examples": [],
        "see_also": [
            {
                "name": "keyctl",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/keyctl/1/json"
            },
            {
                "name": "mke2fs",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/mke2fs/8/json"
            },
            {
                "name": "mount",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/mount/8/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "COMMANDS",
                "lines": 38,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 5,
                "subsections": []
            }
        ]
    }
}