what(1)                                                   what(1)



NAME
     what - reports identification information for a file

SYNOPSIS
     what [-s] file...

ARGUMENTS
     file Specifies the file to be searched.

     -s   Quits after finding the first occurrence of pattern in
          each file.

DESCRIPTION
     what searches the given files for all occurrences of the
     pattern that get substitutes for %Z% (this is @(#) at this
     printing) and prints out what follows until the first ``, >,
     newline, \, or null character.  For example, if the C
     program in file f.c contains

        char ident[] = ``@ (#)
        identification information'';

     and f.c is compiled to yield f.o and a.out, then the command

        what f.c f.o a.out

     will print

          f.c:   identification information

          f.o:   identification information

          a.out: identification information

     The what program is intended to be used in conjunction with
     the SCCS command get, which inserts identifying information
     automatically, but it can also be used where the information
     is inserted manually.

EXAMPLES
     If test1.c has the following string:

        char v[] = "@(#)1 test1.c 2";

     typing

        what test1.c

     would print the following:

        test1.c:
             1 test1.c 2



January 1992                                                    1

what(1)                                                   what(1)



STATUS MESSAGES AND VALUES
     The exit status is 0 if any matches are found, otherwise it
     is 1.  Use the help command for explanations.

LIMITATIONS
     It is possible that an unintended occurrence of the pattern
     @(#) could be found just by chance, but this causes no harm
     in nearly all cases.

FILES
     /usr/bin/what
          Executable file

SEE ALSO
     admin(1), cdc(1), comb(1), delta(1), get(1), help(1),
     prs(1), rmdel(1), sact(1), sccs(1), sccsdiff(1), unget(1),
     val(1)

     sccsfile(4) in A/UX Programmer's Reference

     ``SCCS Reference'' in A/UX Programming Languages and Tools,
     Volume 2

































2                                                    January 1992