val(1)val(1)NAMEval - Validates Source Code Control System (SCCS) files
SYNOPSISval [-m identifier] [-r SID] [-s] [-y type] file...
val-
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
val: XCU5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
OPTIONS
Compares the value identifier with the SCCS %M% identification keyword
in file. See the get command for more information on the %M% keyword.
Specifies the SID (SCCS ID) of the file to be validated. The SID must
be valid and unambiguous. If the SID is valid and unambiguous, it must
exist. Suppresses the error message normally written to standard out‐
put. Specifies a type to compare with the SCCS %Y% identification key‐
word in file. See the get command for more information on the %Y% key‐
word.
OPERANDS
Specifies the pathname of an existing SCCS file.
If you specify no options and a - (dash) for file, val reads
standard input and interprets each line of standard input as if
it were a command-line argument list consisting of val options
and the name of a file. (However, the line is not subjected to
any of the shell word expansions, such as parameter expansion or
quote removal.) An End-of-File key sequence terminates input.
DESCRIPTION
The val command reads files and determines whether each specified file
is an SCCS file meeting the characteristics specified by the options.
The val command displays error messages to standard output for each
file processed, unless the -s option is specified. The val command
also returns a single 8-bit code upon exit, described under EXIT STA‐
TUS.
NOTES
Since the val exit status sets the 0x80 bit, you cannot check $? to
tell if it terminated due to a missing file argument or receipt of a
signal.
EXIT STATUS
The 8-bit code indicates possible mismatches or errors. It is inter‐
preted as a bit string, in which set bits (from left to right) are
interpreted as follows: Missing file argument. Unknown or duplicate
option. Damaged SCCS file. Cannot open file or file not SCCS. SID is
invalid or ambiguous. SID does not exist. %Y%, -y mismatch. %M%, -m
mismatch.
When val processes two or more files on a given command line or multi‐
ple command lines (when reading the standard input), a code is returned
that is a logical OR of the codes generated for each file processed.
EXAMPLES
To determine if file s.test.c is an SCCS text file, enter: val-y text
s.test.c
or: val - -y text s.test.c <Ctrl-d>
where <Ctrl-d> is the End-of-File key sequence. In a directory
with three SCCS files, s.x (of t type “text”), s.y and s.z (a
corrupted file), the following command could produce the output
shown: val - <<EOF -y source s.x -m y s.y s.z EOF
-y source s.x
s.x: %Y%, -y mismatch s.z
s.z: corrupted SCCS file
ENVIRONMENT VARIABLES
The following environment variables affect the execution of val: Pro‐
vides a default value for the internationalization variables that are
unset or null. If LANG is unset or null, the corresponding value from
the default locale is used. If any of the internationalization vari‐
ables contain an invalid setting, the utility behaves as if none of the
variables had been defined. If set to a non-empty string value, over‐
rides the values of all the other internationalization variables.
Determines the locale for the interpretation of sequences of bytes of
text data as characters (for example, single-byte as opposed to multi‐
byte characters in arguments and input files). Determines the locale
for the format and contents of diagnostic messages written to standard
error and informative messages written to standard output. Determines
the location of message catalogues for the processing of LC_MESSAGES.
SEE ALSO
Commands: admin(1), cdc(1), comb(1), delta(1), get(1), prs(1),
rmdel(1), sact(1), sccs(1), sccsdiff(1), sccshelp(1), unget(1), what(1)
Files: sccsfile(4)
Standards: standards(5)
Programming Support Tools
val(1)
