{
    "content": [
        {
            "type": "text",
            "text": "# pam_issue(8) (man)\n\n**Summary:** pamissue - PAM module to add issue file to user prompt\n\n**Synopsis:** pamissue.so [noesc] [issue=issue-file-name]\n\n## Examples\n\n- `Add the following line to /etc/pam.d/login to set the user specific issue at login:`\n- `auth optional pamissue.so issue=/etc/issue`\n\n## See Also\n\n- pam.conf(5)\n- pam.d(5)\n- pam(7)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (38 lines)\n- **OPTIONS** (1 lines) — 1 subsections\n  - noesc (5 lines)\n- **MODULE TYPES PROVIDED** (2 lines)\n- **RETURN VALUES** (12 lines)\n- **EXAMPLES** (6 lines)\n- **SEE ALSO** (2 lines)\n- **AUTHOR** (5 lines)\n\n## Full Content\n\n### NAME\n\npamissue - PAM module to add issue file to user prompt\n\n### SYNOPSIS\n\npamissue.so [noesc] [issue=issue-file-name]\n\n### DESCRIPTION\n\npamissue is a PAM module to prepend an issue file to the username prompt. It also by default\nparses escape codes in the issue file similar to some common getty's (using \\x format).\n\nRecognized escapes:\n\n\\d\ncurrent day\n\n\\l\nname of this tty\n\n\\m\nmachine architecture (uname -m)\n\n\\n\nmachine's network node hostname (uname -n)\n\n\\o\ndomain name of this system\n\n\\r\nrelease number of operating system (uname -r)\n\n\\t\ncurrent time\n\n\\s\noperating system name (uname -s)\n\n\\u\nnumber of users currently logged in\n\n\\U\nsame as \\u except it is suffixed with \"user\" or \"users\" (eg. \"1 user\" or \"10 users\")\n\n\\v\noperating system version and build date (uname -v)\n\n### OPTIONS\n\n#### noesc\n\nTurns off escape code parsing.\n\nissue=issue-file-name\nThe file to output if not using the default.\n\n### MODULE TYPES PROVIDED\n\nOnly the auth module type is provided.\n\n### RETURN VALUES\n\nPAMBUFERR\nMemory buffer error.\n\nPAMIGNORE\nThe prompt was already changed.\n\nPAMSERVICEERR\nA service module error occurred.\n\nPAMSUCCESS\nThe new prompt was set successfully.\n\n### EXAMPLES\n\nAdd the following line to /etc/pam.d/login to set the user specific issue at login:\n\nauth optional pamissue.so issue=/etc/issue\n\n### SEE ALSO\n\npam.conf(5), pam.d(5), pam(7)\n\n### AUTHOR\n\npamissue was written by Ben Collins <bcollins@debian.org>.\n\n\n\nLinux-PAM Manual                             06/08/2020                                 PAMISSUE(8)\n\n"
        }
    ],
    "structuredContent": {
        "command": "pam_issue",
        "section": "8",
        "mode": "man",
        "summary": "pamissue - PAM module to add issue file to user prompt",
        "synopsis": "pamissue.so [noesc] [issue=issue-file-name]",
        "flags": [],
        "examples": [
            "Add the following line to /etc/pam.d/login to set the user specific issue at login:",
            "auth optional pamissue.so issue=/etc/issue"
        ],
        "see_also": [
            {
                "name": "pam.conf",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/pam.conf/5/json"
            },
            {
                "name": "pam.d",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/pam.d/5/json"
            },
            {
                "name": "pam",
                "section": "7",
                "url": "https://www.chedong.com/phpMan.php/man/pam/7/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 38,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "noesc",
                        "lines": 5
                    }
                ]
            },
            {
                "name": "MODULE TYPES PROVIDED",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "RETURN VALUES",
                "lines": 12,
                "subsections": []
            },
            {
                "name": "EXAMPLES",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 5,
                "subsections": []
            }
        ]
    }
}