Return to whereis.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / whereis

Annotation of 43BSDReno/usr.bin/whereis/whereis.1, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1980 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted
        !             5: .\" provided that the above copyright notice and this paragraph are
        !             6: .\" duplicated in all such forms and that any documentation,
        !             7: .\" advertising materials, and other materials related to such
        !             8: .\" distribution and use acknowledge that the software was developed
        !             9: .\" by the University of California, Berkeley.  The name of the
        !            10: .\" University may not be used to endorse or promote products derived
        !            11: .\" from this software without specific prior written permission.
        !            12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
        !            13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
        !            14: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            15: .\"
        !            16: .\"    @(#)whereis.1   6.3 (Berkeley) 3/10/90
        !            17: .\"
        !            18: .TH WHEREIS 1 "March 10, 1990"
        !            19: .UC
        !            20: .SH NAME
        !            21: whereis \- locate source, binary, and or manual for program
        !            22: .SH SYNOPSIS
        !            23: .B whereis
        !            24: [
        !            25: .B \-sbm
        !            26: ] [
        !            27: .B \-u
        !            28: ] [
        !            29: .B \-SBM
        !            30: dir ...
        !            31: .B \-f
        !            32: ] name ...
        !            33: .SH DESCRIPTION
        !            34: .I Whereis
        !            35: locates source/binary and manuals sections for specified files.
        !            36: The supplied names are first stripped of leading pathname components
        !            37: and any (single) trailing extension of the form ``.ext'', e.g. ``.c''.
        !            38: Prefixes of ``s.'' resulting from use of source code control are also
        !            39: dealt with.
        !            40: .I Whereis
        !            41: then attempts to locate the desired program in a list of standard places.
        !            42: If any of the
        !            43: .B \-b,
        !            44: .B \-s
        !            45: or
        !            46: .B \-m
        !            47: flags are given then
        !            48: .I whereis
        !            49: searches only for binaries, sources or manual sections respectively
        !            50: (or any two thereof).
        !            51: The
        !            52: .B \-u
        !            53: flag may be used to search for unusual entries.
        !            54: A file is said to be unusual if it does not have one entry of
        !            55: each requested type.
        !            56: Thus ``whereis -m -u *'' asks for those files in the current
        !            57: directory which have no documentation.
        !            58: .sp
        !            59: Finally, the
        !            60: .B \-B
        !            61: .B \-M
        !            62: and
        !            63: .B \-S
        !            64: flags may be used to change or otherwise limit the places where
        !            65: .I whereis
        !            66: searches.
        !            67: The
        !            68: .B \-f
        !            69: file flags is used to terminate the last such directory list
        !            70: and signal the start of file names.
        !            71: .SH EXAMPLE
        !            72: The following finds all the files in /usr/bin which are not documented
        !            73: in /usr/man/man1 with source in /usr/src/cmd:
        !            74: .IP
        !            75: cd /usr/ucb
        !            76: .br
        !            77: whereis \-u \-M /usr/man/man1 \-S /usr/src/cmd \-f *
        !            78: .SH FILES
        !            79: /usr/src/*
        !            80: .br
        !            81: /usr/{doc,man}/*
        !            82: .br
        !            83: /lib, /etc, /usr/{lib,bin,ucb,old,new,local}
        !            84: .SH BUGS
        !            85: Since the program uses
        !            86: .IR chdir (2)
        !            87: to run faster, pathnames given with the
        !            88: .B \-M
        !            89: .B \-S
        !            90: and
        !            91: .B \-B
        !            92: 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.