Return to whereis.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/whereis.1, revision 1.1

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