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

       -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 system's 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

       -?, --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.  If $MANPATH is prefixed by a
              colon, then the value of the variable is appended to the list
              determined from the content of the configuration files.  If
              the colon comes at the end of the value in the variable, then
              the determined list is appended to the content of the
              variable.  If the value of the variable contains a double
              colon (::), then the determined list is inserted in the middle
              of the value, between the two colons.

       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

       /usr/local/etc/man_db.conf  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 2020-08-13.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-07-04.)  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.8.4                            2018-07-27                       MANPATH(1)

Pages that refer to this page: groffer(1)man(1)