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, see section `Invoking find' in GNU find utilities).

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. In fact, the recognized filename extensions and the allowable names (including any leading `.') are the same. You can also specify an integer for name; this is the only way to specify formats that don't have an associated suffix, such as MetaPost support files and Dvips configuration files. It's also somewhat faster, since no unused formats need to be initialized. The integers appear in the output of `--help', and are of course subject to change. Here's the current list of recognized names and numbers. See section Supported file formats, for more information on each of these.

gf(0)
pk(1)
bitmap font (2)
.afm(3)
.base(4)
.bib(5)
.bst(6)
.cnf(7)
ls-R(8)
.fmt(9)
.map(10)
.mem(11)
.mf(12)
.pool(13)
.mft(14)
.mp(15)
.pool(16)
MetaPost support (17)
.ocp(18)
.ofm(19)
.opl(20)
.otp(21)
.ovf(22)
.ovp(23)
graphic/figure (24) .eps .epsi
.tex(25) .ltx .dtx .texi .texinfo .txi .eps .epsi
TeX documentation (26)
.pool(27)
TeX sources (28)
PostScript header/font (29) .pro
Troff fonts (30)
.tfm(31)
.pfa(32) .pfb
.vf(33)
dvips config (34)
.ist(35)

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

`--interactive'

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

`-maketex=filetype'

`-no-maketex=filetype'

Turn on or off the `MakeTeX' 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. See section `MakeTeX' scripts.

`--mode=string'

Set the mode name to string; this also only affects `gf' and `pk' lookups. No default: any mode will be found. See section `MakeTeX' 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 (see section 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 `--path-expand' 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 (see section Config files).

Go to the first, previous, next, last section, table of contents.