val(1) General Commands Manual val(1)
NAME
val - 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 arguments. The effects of each option apply independently to each specified
file.
Silent option. Suppress diagnostic messages normally generated on the standard output when an error is encountered 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 contained 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 explanations.
SEE ALSO
admin(1), delta(1), get(1), sccshelp(1), prs(1), sccsfile(4).
STANDARDS CONFORMANCE
val(1)