what(1) — Commands
NAME
what − Displays identifying information for Source Code Control System (SCCS) files
SYNOPSIS
what [-s] file ...
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
what: XPG4, XPG4−UNIx
Refer to the standards(5) reference page for more information about industry standards and associated tags.
FLAGS
-sSearches for just the first occurrence of @(#).
PARAMETERS
filePathname of the file to search.
DESCRIPTION
The what command searches the named files for all occurrences of the pattern that get(1) substitutes for the %Z% keyletter, and writes to standard output whatever follows until the first ", >, newline, \ or NUL character.
By convention, the value substituted by get(1) for the %Z% keyletter is @(#). (See the get(1) command or the prs(1) command for a description of identification keywords.)
The what command writes to standard output whatever follows the pattern up to but not including the first " (double quote), > (redirection symbol), newline character, \ (backslash), or null character. If you specify more than one file, each line of output is preceded by the name of the file it is read from; otherwise, the file name is not displayed. If no file is specified, what reads from standard input.
The what command is intended for use in conjunction with the get command, which automatically inserts the identifying information. You can also use the what command on files where the information is inserted manually.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of what:
LANGProvides a default value for the internationalization variables that are unset or null. If LANG is unset or null, the corresponding value from the default locale is used. If any of the internationalization variables contain an invalid setting, the utility behaves as if none of the variables had been defined.
LC_ALLIf set to a non-empty string value, overrides the values of all the other internationalization variables.
LC_CTYPEDetermines the locale for the interpretation of sequences of bytes of text data as characters (for example, single-byte as opposed to multibyte characters in arguments and input files).
LC_MESSAGESDetermines the locale for the format and contents of diagnostic messages written to standard error.
NLSPATHDetermines the location of message catalogues for the processing of LC_MESSAGES.
EXAMPLES
Suppose that the file test.c contains a C program that includes the line:
char ident[ ] = "@(#)Test Program";
If you compile test.c to produce test.o and a.out, then entering the command:
what test.c test.o a.out
displays:
test.c:
Test Program
test.o:
Test Program
a.out:
Test Program
EXIT STATUS
The following exit values are returned:
0Matches were found.
1No matches were found.
RELATED INFORMATION
Commands: admin(1), cdc(1), comb(1), delta(1), get(1), prs(1), rmdel(1), sact(1), sccs(1), sccsdiff(1), sccshelp(1), unget(1), val(1)
Documents: Programming Support Tools