Annotation of src/usr.bin/what/what.1, Revision 1.16
1.16 ! jmc 1: .\" $OpenBSD: what.1,v 1.15 2010/07/19 10:01:32 jmc Exp $
1.1 deraadt 2: .\" $NetBSD: what.1,v 1.3 1994/11/17 06:59:38 jtc Exp $
3: .\"
4: .\" Copyright (c) 1980, 1991, 1993
5: .\" The Regents of the University of California. All rights reserved.
6: .\"
7: .\" Redistribution and use in source and binary forms, with or without
8: .\" modification, are permitted provided that the following conditions
9: .\" are met:
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. Redistributions in binary form must reproduce the above copyright
13: .\" notice, this list of conditions and the following disclaimer in the
14: .\" documentation and/or other materials provided with the distribution.
1.9 millert 15: .\" 3. Neither the name of the University nor the names of its contributors
1.1 deraadt 16: .\" may be used to endorse or promote products derived from this software
17: .\" without specific prior written permission.
18: .\"
19: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29: .\" SUCH DAMAGE.
30: .\"
31: .\" @(#)what.1 8.1 (Berkeley) 6/6/93
32: .\"
1.16 ! jmc 33: .Dd $Mdocdate: July 19 2010 $
1.1 deraadt 34: .Dt WHAT 1
1.4 aaron 35: .Os
1.1 deraadt 36: .Sh NAME
37: .Nm what
38: .Nd "show what versions of object modules were used to construct a file"
39: .Sh SYNOPSIS
40: .Nm what
1.8 nino 41: .Op Fl s
1.14 sobrado 42: .Ar
1.1 deraadt 43: .Sh DESCRIPTION
1.6 aaron 44: .Nm
1.8 nino 45: reads each
46: .Ar file
1.7 deraadt 47: and searches for sequences of either the form
1.10 jmc 48: .Sq $
1.7 deraadt 49: immediately followed by the system name (sysname) as defined by
50: .Xr uname 3 ,
51: or the form
1.10 jmc 52: .Dq @(#)
53: as inserted by the source code control system (SCCS).
1.6 aaron 54: It prints the remainder
1.8 nino 55: of the string following this marker, up to a NUL, newline, double
56: quote, backslash, or
1.10 jmc 57: .Sq \*(Gt
1.3 aaron 58: character.
1.8 nino 59: .Pp
60: If the
61: .Fl s
62: option is specified, only the first occurrence of an identification string in
63: each file is printed.
1.16 ! jmc 64: .Sh EXIT STATUS
1.8 nino 65: The
66: .Nm
67: utility exits with a return value of 0 if any identification strings were found,
68: or with a return value of 1 otherwise.
69: .Sh STANDARDS
70: The
71: .Nm
1.11 jmc 72: utility is compliant with the
1.12 jmc 73: .St -xpg4
1.8 nino 74: specification.
1.5 aaron 75: .Sh HISTORY
76: The
77: .Nm
78: command appeared in
79: .Bx 4.0 .
1.1 deraadt 80: .Sh BUGS
81: As
82: .Bx
83: is not licensed to distribute
1.8 nino 84: .Tn SCCS ,
1.1 deraadt 85: this is a rewrite of the
1.6 aaron 86: .Nm
1.1 deraadt 87: command which is part of
1.8 nino 88: .Tn SCCS .
89: As such it may not behave exactly the same as that
1.1 deraadt 90: command does.