manpath(1) — Linux manual page


MANPATH(1)                 Manual pager utils                 MANPATH(1)

NAME         top

       manpath - determine search path for manual pages

SYNOPSIS         top

       manpath [-qgdc?V] [-m system[,...]] [-C file]

DESCRIPTION         top

       If $MANPATH is set, manpath will simply display its contents and
       issue a warning.  If not, manpath will determine a suitable
       manual page hierarchy search path and display the results.

       The colon-delimited path is determined using information gained
       from the man-db configuration file – (/usr/local/etc/man_db.conf)
       and the user's environment.

OPTIONS         top

       -q, --quiet
              Do not issue warnings.

       -d, --debug
              Print debugging information.

       -c, --catpath
              Produce a catpath as opposed to a manpath.  Once the
              manpath is determined, each path element is converted to
              its relative catpath.

       -g, --global
              Produce a manpath consisting of all paths named as
              "global" within the man-db configuration file.

       -m system[,...], --systems=system[,...]
              If this system has access to other operating systems'
              manual hierarchies, this option can be used to include
              them in the output of manpath.  To include NewOS's manual
              page hierarchies use the option -m NewOS.

              The system specified can be a combination of comma
              delimited operating system names.  To include the native
              operating system's manual page hierarchies, the system
              name man must be included in the argument string.  This
              option will override the $SYSTEM environment variable.

       -C file, --config-file=file
              Use this user configuration file rather than the default
              of ~/.manpath.

       -?, --help
              Print a help message and exit.

              Print a short usage message and exit.

       -V, --version
              Display version information.

ENVIRONMENT         top

              If $MANPATH is set, manpath displays its value rather than
              determining it on the fly.

              See the SEARCH PATH section of manpath(5) for the default
              behaviour and details of how this environment variable is

       SYSTEM If $SYSTEM is set, it will have the same effect as if it
              had been specified as the argument to the -m option.

FILES         top

              man-db configuration file.

SEE ALSO         top

       apropos(1), man(1), whatis(1)

AUTHOR         top

       Wilf. (
       Fabrizio Polacco (
       Colin Watson (

BUGS         top

COLOPHON         top

       This page is part of the man-db (manual pager suite) project.
       Information about the project can be found at 
       ⟨⟩.  If you have a bug report for
       this manual page, send it to  This page
       was obtained from the project's upstream Git repository
       ⟨⟩ on 2022-12-17.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2022-11-29.)  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

2.11.1                         2022-11-15                     MANPATH(1)

Pages that refer to this page: man(1)