NAME

val − validate SCCS file

SYNOPSIS

val −
val [ −s ] [ −rSID ] [ −mname ] [ −ytype ] file ...

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. 

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. 

OPTIONS

Options apply independently to each named file on the command line. 

−sSilence diagnostic messages normally generated for errors detected while processing the specified files. 

−rSID
The argument value SID (SCCS IDentification String) is an SCCS delta number.  A check is made to determine if the SID is ambiguous (for instance, r 1 is ambiguous because it physically does not exist but implies 1.1, 1.2, etc. which may exist) or invalid (for instance, r 1.0 or r 1.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
name is compared with the SCCS %M% keyword in file.

−ytype
type is compared with the SCCS %Y% keyword in file.

The 8-bit code returned by val is a disjunction of the possible errors, that is, 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 option;
bit 2 = corrupted SCCS file;
bit 3 = can’t 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). 
Source Code Control System User’s Guide by L. E. Bonanni and C. A. Salemi. 
An Introduction to the Source Code Control System, by Eric Allman. 

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. 

Sun System Release 0.3  —  15 April 1983