{
    "mode": "man",
    "parameter": "GIT-CHECK-MAILMAP",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/GIT-CHECK-MAILMAP/1/json",
    "generated": "2026-06-15T13:40:43Z",
    "synopsis": "git check-mailmap [<options>] <contact>...",
    "sections": {
        "NAME": {
            "content": "git-check-mailmap - Show canonical names and email addresses of contacts\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "git check-mailmap [<options>] <contact>...\n\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "For each “Name <user@host>” or “<user@host>” from the command-line or standard input (when\nusing --stdin), look up the person’s canonical name and email address (see \"Mapping Authors\"\nbelow). If found, print them; otherwise print the input as-is.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "--stdin",
                    "content": "Read contacts, one per line, from the standard input after exhausting contacts provided\non the command-line.\n",
                    "long": "--stdin"
                }
            ]
        },
        "OUTPUT": {
            "content": "For each contact, a single line is output, terminated by a newline. If the name is provided\nor known to the mailmap, “Name <user@host>” is printed; otherwise only “<user@host>” is\nprinted.\n",
            "subsections": []
        },
        "CONFIGURATION": {
            "content": "See mailmap.file and mailmap.blob in git-config(1) for how to specify a custom .mailmap\ntarget file or object.\n",
            "subsections": []
        },
        "MAPPING AUTHORS": {
            "content": "See gitmailmap(5).\n",
            "subsections": []
        },
        "GIT": {
            "content": "Part of the git(1) suite\n\n\n\nGit 2.34.1                                   02/26/2026                         GIT-CHECK-MAILMAP(1)",
            "subsections": []
        }
    },
    "summary": "git-check-mailmap - Show canonical names and email addresses of contacts",
    "flags": [
        {
            "flag": "",
            "long": "--stdin",
            "arg": null,
            "description": "Read contacts, one per line, from the standard input after exhausting contacts provided on the command-line."
        }
    ],
    "examples": [],
    "see_also": [],
    "tldr": {
        "source": "official",
        "description": "Show canonical names and email addresses of contacts.",
        "examples": [
            {
                "description": "Look up the canonical name associated with an email address",
                "command": "git check-mailmap {{email@example.com}}"
            },
            {
                "description": "Use the specified mailmap file in addition to the defaults",
                "command": "git check-mailmap --mailmap-file {{path/to/file}} {{email@example.com}}"
            }
        ]
    }
}