VAL(1) (Source Code Control System Utilities) VAL(1)
NAME
val - validate SCCS file
SYNOPSIS
val -
val [-s] [-rSID] [-mname] [-ytype] files
DESCRIPTION
val determines if the specified file is an SCCS file meeting
the characteristics specified by the optional argument list.
Arguments to val may appear in any order. The arguments
consist of keyletter arguments, which begin with a -, and
named files.
val has a special argument, -, which causes reading of the
standard input 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 keyletter arguments are defined as follows. The effects
of any keyletter argument apply independently to each named
file on the command line.
-s The presence of this argument silences the
diagnostic message normally generated on the
standard output for any error that is detected
while processing each named file on a given
command line.
-rSID The argument value SID (SCCS IDentification
String) is an SCCS delta number. A check is
made to determine if the SID is ambiguous (e.
g., r1 is ambiguous because it physically does
not exist but implies 1.1, 1.2, etc., which may
exist) or invalid (e. g., r1.0 or r1.1.0 are
invalid because neither case can exist as a
Page 1 May 1989
VAL(1) (Source Code Control System Utilities) VAL(1)
valid delta number). If the SID is valid and
not ambiguous, a check is made to determine if
it actually exists.
-mname The argument value name is compared with the
s-1SCCS %M% keyword in file.
-ytype The argument value type is compared with the
SCCS %Y% keyword in file.
The 8-bit code returned by val is a disjunction of the
possible errors, i. e., 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.
SEE ALSO
admin(1), delta(1), get(1), prs(1).
help(1) in the User's Reference Manual.
DIAGNOSTICS
Use help(1) for explanations.
BUGS
val can process up to 50 files on a single command line.
Any number above 50 will produce a core dump.
Page 2 May 1989