git-check-mailmap(1) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| OPTIONS \| OUTPUT \| CONFIGURATION \| MAPPING AUTHORS \| GIT \| COLOPHON

GIT-CHECK-MAILMAP(1)            Git Manual           GIT-CHECK-MAILMAP(1)

NAME top

       git-check-mailmap - Show canonical names and email addresses of
       contacts

SYNOPSIS top

       git check-mailmap [<options>] <contact>...

DESCRIPTION top

       For each “Name <user@host>”, “<user@host>”, or “user@host” from
       the command-line or standard input (when using --stdin), look up
       the person’s canonical name and email address (see "Mapping
       Authors" below). If found, print them; otherwise print the input
       as-is.

OPTIONS top

       --stdin
           Read contacts, one per line, from the standard input after
           exhausting contacts provided on the command-line.

       --mailmap-file=<file>
           In addition to any configured mailmap files, read the
           specified mailmap file. Entries in this file take precedence
           over entries in either the default mailmap file or any
           configured mailmap file.

       --mailmap-blob=<blob>
           Like --mailmap-file, but consider the value as a reference to
           a blob in the repository. If both --mailmap-file and
           --mailmap-blob are specified, entries in --mailmap-file will
           take precedence.

OUTPUT top

       For each contact, a single line is output, terminated by a
       newline. If the name is provided or known to the mailmap, “Name
       <user@host>” is printed; otherwise only “<user@host>” is printed.

CONFIGURATION top

       See mailmap.file and mailmap.blob in git-config(1) for how to
       specify a custom .mailmap target file or object.

MAPPING AUTHORS top

       See gitmailmap(5).

GIT top

       Part of the git(1) suite

COLOPHON top

       This page is part of the git (Git distributed version control
       system) project.  Information about the project can be found at 
       ⟨http://git-scm.com/⟩.  If you have a bug report for this manual
       page, see ⟨http://git-scm.com/community⟩.  This page was obtained
       from the project's upstream Git repository
       ⟨https://github.com/git/git.git⟩ on 2025-08-11.  (At that time,
       the date of the most recent commit that was found in the
       repository was 2025-08-07.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

Git 2.51.0.rc1                  2025-08-07           GIT-CHECK-MAILMAP(1)

Pages that refer to this page: git(1), gitmailmap(5)