Go to main content

man pages section 5: File Formats

Exit Print View

Updated: Wednesday, February 9, 2022

updatedb.conf (5)


updatedb.conf - a configuration file for updatedb(8)


Please see following description for synopsis


updatedb.conf(5)              File Formats Manual             updatedb.conf(5)

       /etc/updatedb.conf - a configuration file for updatedb(8)

       /etc/updatedb.conf is a text file.  Blank lines are ignored.  A # char-
       acter outside of a quoted string starts a comment extending  until  end
       of line.

       Other lines must be of the following form:
              VARIABLE = "VALUE"

       White  space  between  tokens  is ignored.  VARIABLE is an alphanumeric
       string which does not start with a digit.  VALUE can contain any  char-
       acter  except for ".  No escape mechanism is supported within VALUE and
       there is no way to write VALUE spanning more than one line.

       Unknown VARIABLE values are considered an error.  The defined variables

              A  whitespace-separated  list  of  file system types (as used in
              /etc/mtab) which should not be scanned by updatedb(8).  The file
              system  type  matching is case-insensitive.  By default, no file
              system types are skipped.

              When scanning a file system is skipped, all file systems mounted
              in  the  subtree  are  skipped  too, even if their type does not
              match any entry in PRUNEFS.

              A whitespace-separated list of directory names  (without  paths)
              which  should  not  be  scanned  by updatedb(8).  By default, no
              directory names are skipped.

              Note that only directories can  be  specified,  and  no  pattern
              mechanism (e.g.  globbing) is used.

              A  whitespace-separated  list of path names of directories which
              should not be scanned by updatedb(8).  Each path  name  must  be
              exactly  in the form in which the directory would be reported by

              By default, no paths are skipped.

              One of the strings 0, no, 1 or yes.  If PRUNE_BIND_MOUNTS  is  1
              or  yes,  bind  mounts are not scanned by updatedb(8).  All file
              systems mounted in the subtree of a bind mount  are  skipped  as
              well,  even  if they are not bind mounts.  As an exception, bind
              mounts of a directory on itself are not skipped.

              By default, bind mounts are not skipped.

       See attributes(7) for descriptions of the following attributes:

       |Availability   | file/mlocate     |
       |Stability      | Uncommitted      |

       When a directory is  matched  by  PRUNEFS,  PRUNENAMES  or  PRUNEPATHS,
       updatedb(8)  does  not scan the contents of the directory.  The path of
       the directory itself is, however, entered in the created database.  For
       example,  if  /tmp  is in PRUNEPATHS, locate(1) will not show any files
       stored in /tmp, but it can show the /tmp directory.  This behavior dif-
       fers from traditional locate implementations.

       In  some  updatedb(8) implementations PRUNEPATHS can be used to exclude
       non-directory files.  This is not the case in this implementation.

       /etc/updatedb.conf is a shell script  in  some  implementations,  which
       allows  much  more  flexibility  in defining the variables.  Equivalent
       functionality can be achieved by  using  the  command-line  options  to

       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source  was  downloaded  from  https://releases.pagure.org/mlocate/mlo-

       Further information about this software can be found on the open source
       community website at https://pagure.io/mlocate.

       Miloslav Trmac <mitr@redhat.com>

       locate(1), updatedb(8)

mlocate                            Jun 2008                   updatedb.conf(5)