{
    "content": [
        {
            "type": "text",
            "text": "# PAM_CHAUTHTOK (man)\n\n## NAME\n\npamchauthtok - updating authentication tokens\n\n## SYNOPSIS\n\n#include <security/pamappl.h>\nint pamchauthtok(pamhandlet *pamh, int flags);\n\n## DESCRIPTION\n\nThe pamchauthtok function is used to change the authentication token for a given user (as\nindicated by the state associated with the handle pamh).\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **RETURN VALUES**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "PAM_CHAUTHTOK",
        "section": "",
        "mode": "man",
        "summary": "pamchauthtok - updating authentication tokens",
        "synopsis": "#include <security/pamappl.h>\nint pamchauthtok(pamhandlet *pamh, int flags);",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [
            {
                "name": "pamstart",
                "section": "3",
                "url": "https://www.chedong.com/phpMan.php/man/pamstart/3/json"
            },
            {
                "name": "pamauthenticate",
                "section": "3",
                "url": "https://www.chedong.com/phpMan.php/man/pamauthenticate/3/json"
            },
            {
                "name": "pamsetcred",
                "section": "3",
                "url": "https://www.chedong.com/phpMan.php/man/pamsetcred/3/json"
            },
            {
                "name": "pamgetitem",
                "section": "3",
                "url": "https://www.chedong.com/phpMan.php/man/pamgetitem/3/json"
            },
            {
                "name": "pamstrerror",
                "section": "3",
                "url": "https://www.chedong.com/phpMan.php/man/pamstrerror/3/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": 4,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 14,
                "subsections": []
            },
            {
                "name": "RETURN VALUES",
                "lines": 26,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 5,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "pamchauthtok - updating authentication tokens\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "#include <security/pamappl.h>\n\nint pamchauthtok(pamhandlet *pamh, int flags);\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "The pamchauthtok function is used to change the authentication token for a given user (as\nindicated by the state associated with the handle pamh).\n\nThe pamh argument is an authentication handle obtained by a prior call to pamstart(). The\nflags argument is the binary or of zero or more of the following values:\n\nPAMSILENT\nDo not emit any messages.\n\nPAMCHANGEEXPIREDAUTHTOK\nThis argument indicates to the modules that the user's authentication token (password)\nshould only be changed if it has expired. If this argument is not passed, the application\nrequires that all authentication tokens are to be changed.\n",
                "subsections": []
            },
            "RETURN VALUES": {
                "content": "PAMAUTHTOKERR\nA module was unable to obtain the new authentication token.\n\nPAMAUTHTOKRECOVERYERR\nA module was unable to obtain the old authentication token.\n\nPAMAUTHTOKLOCKBUSY\nOne or more of the modules was unable to change the authentication token since it is\ncurrently locked.\n\nPAMAUTHTOKDISABLEAGING\nAuthentication token aging has been disabled for at least one of the modules.\n\nPAMPERMDENIED\nPermission denied.\n\nPAMSUCCESS\nThe authentication token was successfully updated.\n\nPAMTRYAGAIN\nNot all of the modules were in a position to update the authentication token(s). In such\na case none of the user's authentication tokens are updated.\n\nPAMUSERUNKNOWN\nUser unknown to password service.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "pamstart(3), pamauthenticate(3), pamsetcred(3), pamgetitem(3), pamstrerror(3), pam(7)\n\n\n\nLinux-PAM Manual                             06/08/2020                             PAMCHAUTHTOK(3)",
                "subsections": []
            }
        }
    }
}