VAL(1) INTERACTIVE UNIX System VAL(1)
NAME
val - validate SCCS file
SYNOPSIS
val -
val [-s] [-rSID] [-mname] [-ytype] files
DESCRIPTION
The val command 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.
The val command 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.
The val command generates diagnostic messages on the stan-
dard 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 diag-
nostic message normally generated on the stan-
dard 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
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
SCCS %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 pos-
sible errors, i. e., can be interpreted as a bit string
Rev. C Software Development Set Page 1
VAL(1) INTERACTIVE UNIX System VAL(1)
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 com-
mand line and in turn can process multiple command lines
(when reading the standard input). In these cases an aggre-
gate 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 INTERACTIVE UNIX System User's/System
Administrator's Reference Manual.
DIAGNOSTICS
Use help(1) for explanations.
BUGS
The val command can process up to 50 files on a single com-
mand line. Any number above 50 will produce a core dump.
Rev. C Software Development Set Page 2