VAL(1)
NAME
val − validate SCCS file
USAGE
val −
val [ −s ] [ −rSID ] [ −mname ] [ −ytype ] files
DESCRIPTION
Val determines if the specified file is an SCCS file that meets the characteristics specified by the optional argument list. Options may appear in any order, as long as they are listed before filenames. The effects of any option applies independently to each named file on the command line.
Val uses the dash (−) as a special argument, causing the standard input to be read until an end-of-file condition is detected. Each line read is independently processed as if it were a command line argument list.
Val generates diagnostic messages on the standard output for each command line and file processed, and also returns a single 8-bit code upon exit as described below.
The 8-bit code returned by val is a disjunction of the possible errors, i.e., it can be interpreted as a bit string where (moving from left to right) set bits are interpreted as follows:
bit 0 = missing file argument
bit 1 = unknown or duplicate keyletter argument
bit 2 = corrupted SCCS file
bit 3 = cannot open file or file not SCCS
bit 4 = SID is invalid or ambiguous
bit 5 = SID does not exist
bit 6 = %Y%, −y mismatch;
bit 7 = %M%, −m mismatch;
Note that val can process two or more files on a given command line and in turn can process multiple command lines (when reading the standard input). In these cases, an aggregate code is returned − a logical OR of the codes generated for each command line and file processed.
OPTIONS
−s Silence the diagnostic message normally generated on the standard output for any error detected while processing each named file on a given command line.
−rSID Check to see whether the value of SID (an SCCS delta number) is ambiguous or invalid. For example, r1 is ambiguous because it physically does not exist but implies 1.1, 1.2, etc., which may exist. Furthermore, r1.0 or r1.1.0 are invalid because neither case can exist as a valid delta number. If the SID is valid and not ambiguous, this option also checks to see if it actually exists.
−mname Compare the value of name with the SCCS %M% keyword in file.
−ytype Compare the value of type with the SCCS %Y% keyword in file.
CAUTIONS
Val can process up to 50 files on a single command line. Any number above 50 produces a core dump.
DIAGNOSTICS
Use help (1) for explanations.