GNU Info

(kpathsea.info)Path searching options

---

Next: Auxiliary tasks Up: Invoking kpsewhich

---

Enter node , (file) or (file)node

Path searching options
----------------------

  Kpsewhich looks up each non-option argument on the command line as a
filename, and returns the first file found.  There is no option to
return all the files with a particular name (you can run the Unix
`find' utility for that, Note: Invoking find.
).

  Various options alter the path searching behavior:

`--dpi=NUM'
     Set the resolution to NUM; this only affects `gf' and `pk'
     lookups.  `-D' is a synonym, for compatibility with Dvips.
     Default is 600.

`--format=NAME'
     Set the format for lookup to NAME.  By default, the format is
     guessed from the filename, with `tex' being used if nothing else
     fits.  The recognized filename extensions (including any leading
     `.') are also allowable NAMEs.

     All formats also have a name, which is the only way to specify
     formats with no associated suffix.  For example, for Dvips
     configuration files you can use `--format="dvips config"'.  (The
     quotes are for the sake of the shell.)

     Here's the current list of recognized names and the associated
     suffixes.  Note: Supported file formats, for more information on
     each of these.
          gf: gf
          pk: pk
          bitmap font
          afm: .afm
          base: .base
          bib: .bib
          bst: .bst
          cnf: .cnf
          ls-R: ls-R
          fmt: .fmt
          map: .map
          mem: .mem
          mf: .mf
          mfpool: .pool
          mft: .mft
          mp: .mp
          mppool: .pool
          MetaPost support
          ocp: .ocp
          ofm: .ofm .tfm
          opl: .opl
          otp: .otp
          ovf: .ovf
          ovp: .ovp
          graphic/figure: .eps .epsi
          tex: .tex
          TeX system documentation
          texpool: .pool
          TeX system sources
          PostScript header/font: .pro
          Troff fonts
          tfm: .tfm
          type1 fonts: .pfa .pfb
          vf: .vf
          dvips config
          ist: .ist
          truetype fonts: .ttf .ttc
          type42 fonts
          web2c files
          other text files
          other binary files

     This option and `--path' are mutually exclusive.

`--interactive'
     After processing the command line, read additional filenames to
     look up from standard input.

`-mktex=FILETYPE'
`-no-mktex=FILETYPE'
     Turn on or off the `mktex' script associated with FILETYPE.  The
     only values that make sense for FILETYPE are `pk', `mf', `tex',
     and `tfm'. By default, all are off in Kpsewhich.  Note: mktex
     scripts.

`--mode=STRING'
     Set the mode name to STRING; this also only affects `gf' and `pk'
     lookups.  No default: any mode will be found.  Note: mktex script
     arguments.

`--must-exist'
     Do everything possible to find the files, notably including
     searching the disk.  By default, only the `ls-R' database is
     checked, in the interest of efficiency.

`--path=STRING'
     Search along the path STRING (colon-separated as usual), instead
     of guessing the search path from the filename.  `//' and all the
     usual expansions are supported (Note: Path expansion).  This
     option and `--format' are mutually exclusive.  To output the
     complete directory expansion of a path, instead of doing a
     one-shot lookup, see `--expand-path' in the following section.

`--progname=NAME'
     Set the program name to NAME; default is `kpsewhich'.  This can
     affect the search paths via the `.PROGNAM' feature in
     configuration files (Note: Config files).