{
    "mode": "man",
    "parameter": "PAM_STRESS",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/PAM_STRESS/8/json",
    "generated": "2026-10-06T11:17:32Z",
    "synopsis": "pamstress.so [debug] [nowarn] [usefirstpass] [tryfirstpass] [rootok] [expired] [fail1]\n[fail2] [prelim] [required]",
    "sections": {
        "NAME": {
            "content": "pamstress - The stress-testing PAM module\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "pamstress.so [debug] [nowarn] [usefirstpass] [tryfirstpass] [rootok] [expired] [fail1]\n[fail2] [prelim] [required]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "The pamstress PAM module is mainly intended to give the impression of failing as a fully\nfunctioning module might.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "debug\nPut lots of information in syslog. *NOTE* this option writes passwords to syslog, so\ndon't use anything sensitive when testing.\n\nnowarn\nDo not give warnings about things (otherwise warnings are issued via the conversation\nfunction)\n\nusefirstpass\nDo not prompt for a password, for pamsmauthentication function just use item\nPAMAUTHTOK.\n\ntryfirstpass\nDo not prompt for a password unless there has been no previous authentication token (item\nPAMAUTHTOK is NULL)\n\nrootok\nThis is intended for the pamsmchauthtok function and it instructs this function to\npermit root to change the user's password without entering the old password.\n\nexpired\nAn argument intended for the account and chauthtok module parts. It instructs the module\nto act as if the user's password has expired\n\nfail1\nThis instructs the module to make its first function fail.\n\nfail2\nThis instructs the module to make its second function (if there is one) fail.\n\nprelim\nFor pamsmchauthtok, means fail on PAMPRELIMCHECK.\n\nrequired\nFor pamsmchauthtok, means fail if the user hasn't already been authenticated by this\nmodule. (See stressnewpwd data string in the NOTES.)\n",
            "subsections": []
        },
        "MODULE TYPES PROVIDED": {
            "content": "All module types (auth, account, password and session) are provided.\n",
            "subsections": []
        },
        "RETURN VALUES": {
            "content": "PAMBUFERR\nMemory buffer error.\n\nPAMPERMDENIED\nPermission denied.\n\nPAMAUTHERR\nAccess to the system was denied.\n\nPAMCONVERR\nConversation failure.\n\nPAMSUCCESS\nThe function passes all checks.\n\nPAMUSERUNKNOWN\nThe user is not known to the system.\n\nPAMCREDERR\nFailure involving user credentials.\n\nPAMNEWAUTHTOKREQD\nAuthentication token is no longer valid; new one required.\n\nPAMSESSIONERR\nSession failure.\n\nPAMTRYAGAIN\nFailed preliminary check by service.\n\nPAMAUTHTOKLOCKBUSY\nAuthentication token lock busy.\n\nPAMAUTHTOKERR\nAuthentication token manipulation error.\n\nPAMSYSTEMERR\nSystem error.\n",
            "subsections": []
        },
        "NOTES": {
            "content": "This module uses the stressnewpwd data string which tells pamsmchauthtok that\npamsmacctmgmt says we need a new password. The only possible value for this data string is\n'yes'.\n",
            "subsections": []
        },
        "EXAMPLES": {
            "content": "#%PAM-1.0\n#\n# Any of the following will suffice\naccount  required pamstress.so\nauth     required pamstress.so\npassword required pamstress.so\nsession  required pamstress.so\n\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "pam.conf(5), pam.d(5), pam(8).\n",
            "subsections": []
        },
        "AUTHORS": {
            "content": "The pamstress PAM module was developed by Andrew Morgan <morgan@linux.kernel.org>. The man\npage for pamstress was written by Lucas Ramage <ramage.lucas@protonmail.com>.\n\nLinux-PAM                                    05/07/2023                                PAMSTRESS(8)",
            "subsections": []
        }
    },
    "summary": "pamstress - The stress-testing PAM module",
    "flags": [],
    "examples": [
        "#%PAM-1.0",
        "# Any of the following will suffice",
        "account  required pamstress.so",
        "auth     required pamstress.so",
        "password required pamstress.so",
        "session  required pamstress.so"
    ],
    "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": "8",
            "url": "https://www.chedong.com/phpMan.php/man/pam/8/json"
        }
    ]
}