VAL(1) GENIX Programmer's Manual 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 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 val.1 keyword in file.
-ytype The argument value type is compared with the
SCCS Unix System Command Manual Page 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:
Printed 11/16/83 1
VAL(1) GENIX Programmer's Manual VAL(1)
bit 0 = missing file argument;
bit 1 = unknown or duplicate keyletter argument;
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 = Unix System Command Manual Page, -y mismatch;
bit 7 = val.1, -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
sccs(1), admin(1), delta(1), get(1), prs(1), prt(1).
DIAGNOSTICS
Use sccshelp(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.
Printed 11/16/83 2