val - Validates Source Code Control System (SCCS) files
val [-m identifier] [-r SID] [-s] [-y type] file...
Interfaces documented on this reference page conform to
industry standards as follows:
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
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 output. Specifies a type to compare with the
SCCS %Y% identification keyword in file. See the get command
for more information on the %Y% keyword.
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-ofFile
key sequence terminates input.
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 STATUS.
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.
The 8-bit code indicates possible mismatches or errors.
It is interpreted 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 multiple command lines (when reading the standard
input), a code is returned that is a logical OR of the
codes generated for each file processed.
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 [Toc] [Back]
The following environment variables affect the execution
of val: Provides 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 variables contain
an invalid setting, the utility behaves as if none of
the variables had been defined. If set to a non-empty
string value, overrides 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 multibyte
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.
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)
Programming Support Tools
[ Back ]