|
|
1.1 ! root 1: .TH WHEREIS 1 "24 February 1979" ! 2: .UC ! 3: .SH NAME ! 4: whereis \- locate source, binary, and or manual for program ! 5: .SH SYNOPSIS ! 6: .B whereis ! 7: [ ! 8: .B \-sbm ! 9: ] [ ! 10: .B \-u ! 11: ] [ ! 12: .B \-SBM ! 13: dir ... ! 14: .B \-f ! 15: ] name ... ! 16: .SH DESCRIPTION ! 17: .I Whereis ! 18: locates source/binary and manuals sections for specified files. ! 19: The supplied names are first stripped of leading pathname components ! 20: and any (single) trailing extension of the form ``.ext'', e.g. ``.c''. ! 21: Prefixes of ``s.'' resulting from use of source code control are also ! 22: dealt with. ! 23: .I Whereis ! 24: then attempts to locate the desired program in a list of standard places. ! 25: If any of the ! 26: .B \-b, ! 27: .B \-s ! 28: or ! 29: .B \-m ! 30: flags are given then ! 31: .I whereis ! 32: searches only for binaries, sources or manual sections respectively ! 33: (or any two thereof). ! 34: The ! 35: .B \-u ! 36: flag may be used to search for unusual entries. ! 37: A file is said to be unusual if it does not have one entry of ! 38: each requested type. ! 39: Thus ``whereis -m -u *'' asks for those files in the current ! 40: directory which have no documentation. ! 41: .sp ! 42: Finally, the ! 43: .B \-B ! 44: .B \-M ! 45: and ! 46: .B \-S ! 47: flags may be used to change or otherwise limit the places where ! 48: .I whereis ! 49: searches. ! 50: The ! 51: .B \-f ! 52: file flags is used to terminate the last such directory list ! 53: and signal the start of file names. ! 54: .SH EXAMPLE ! 55: The following finds all the files in /usr/bin which are not documented ! 56: in /usr/man/man1 with source in /usr/src/cmd: ! 57: .IP ! 58: cd /usr/ucb ! 59: .br ! 60: whereis \-u \-M /usr/man/man1 \-S /usr/src/cmd \-f * ! 61: .SH FILES ! 62: /usr/src/* ! 63: .br ! 64: /usr/{doc,man}/* ! 65: .br ! 66: /lib, /etc, /usr/{lib,bin,ucb,old,new,local} ! 67: .SH AUTHOR ! 68: William Joy ! 69: .SH BUGS ! 70: Since the program uses ! 71: .IR chdir (2) ! 72: to run faster, pathnames given with the ! 73: .B \-M ! 74: .B \-S ! 75: and ! 76: .B \-B ! 77: must be full; i.e. they must begin with a ``/''.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.