val(1)val(1)NAMEval - validate SCCS file
SYNOPSIS
SID] name] type] files
DESCRIPTION
The command reads one or more files to determine whether each file read
is an SCCS file meeting the characteristics specified by the optional
argument list. Command-line options may appear in any order, and are
described below.
Options
The command recognizes the following options and command-line argu‐
ments. The effects of each option apply independently to each speci‐
fied file.
Silent option. Suppress diagnostic messages normally generated
on the standard output when an error is encoun‐
tered while processing any specified file.
Check existence of revision
SID in file where SID (SCCS IDentification
string) is an SCCS delta number. SID is first
checked to ensure that it is unambiguous and
valid before checking file. For example, is
ambiguous because it physically does not exist
but implies 1.1, 1.2, etc., which may exist; and
are invalid because they have a zero suffix which
never appears in a valid delta number.
name is compared with the SCCS keyword in file.
type is compared with the SCCS keyword in file.
Verbose option.
Prints additional detailed diagnostic messages on
the standard output for any corruption detected
while processing each named file. The messages
are intended for use with the information con‐
tained in sccsfile(4) when fixing the file.
file One or more SCCS files to be processed. If is
used as a file argument, reads the standard input
until an end-of-file condition is encountered.
Each line read is independently processed as if
it were a command-line argument list.
EXTERNAL INFLUENCES
Environment Variables
determines the interpretation of text within file as single- and/or
multi-byte characters.
determines the language in which messages are displayed.
If or is not specified in the environment or is set to the empty
string, the value of is used as a default for each unspecified or empty
variable. If is not specified or is set to the empty string, a default
of "C" (see lang(5)) is used instead of
If any internationalization variable contains an invalid setting,
behaves as if all internationalization variables are set to "C". See
environ(5).
International Code Set Support
Single-byte and multi-byte character code sets are supported.
RETURN VALUE
The 8-bit code returned by 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 Interpretation
0 Missing file argument;
1 Unknown or duplicate option argument;
2 Corrupt SCCS file;
3 Cannot open file or file is not an SCCS file;
4 SID is invalid or ambiguous;
5 SID does not exist;
6 does not match type argument;
7 does not match name argument;
Note that 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 of the
codes generated for each command line and file processed.
DIAGNOSTICS
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 earlier under Use the sccshelp(1) command for explana‐
tions.
SEE ALSOadmin(1), delta(1), get(1), sccshelp(1), prs(1), sccsfile(4).
STANDARDS CONFORMANCEval(1)
