{
    "mode": "man",
    "parameter": "pam_issue",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/pam_issue/8/json",
    "generated": "2026-05-30T07:09:00Z",
    "synopsis": "pamissue.so [noesc] [issue=issue-file-name]",
    "sections": {
        "NAME": {
            "content": "pamissue - PAM module to add issue file to user prompt\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "pamissue.so [noesc] [issue=issue-file-name]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "pamissue 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",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "noesc",
                    "content": "Turns off escape code parsing.\n\nissue=issue-file-name\nThe file to output if not using the default.\n"
                }
            ]
        },
        "MODULE TYPES PROVIDED": {
            "content": "Only the auth module type is provided.\n",
            "subsections": []
        },
        "RETURN VALUES": {
            "content": "PAMBUFERR\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",
            "subsections": []
        },
        "EXAMPLES": {
            "content": "Add 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\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "pam.conf(5), pam.d(5), pam(7)\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "pamissue was written by Ben Collins <bcollins@debian.org>.\n\n\n\nLinux-PAM Manual                             06/08/2020                                 PAMISSUE(8)",
            "subsections": []
        }
    },
    "summary": "pamissue - PAM module to add issue file to user prompt",
    "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"
        }
    ]
}