NAME
val — validate SCCS file
SYNOPSIS
val -
val
[-s]
[-r
SID]
[-m
name]
[-y
type]
[-v]
files
DESCRIPTION
The
val
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
val
command recognizes the following options and command-line arguments.
The effects of each option apply independently
to each specified
file.
- -s
Silent option.
Suppress diagnostic messages normally generated
on the standard output when an error is encountered
while processing any specified
file.
- -r SID
Check existence of revision
SID
in
file
where
SID
(SCCS
ID
entification string) is an
SCCS delta number.
SID
is first checked to ensure that it is unambiguous and valid
before checking
file.
For example,
*-r1
is ambiguous because it physically does not exist
but implies 1.1, 1.2, etc., which may exist;
*-r1.0
and
*-r1.1.0
are invalid because they have a zero suffix
which never appears in a valid delta number.
- -m name
name
is compared with the
SCCS
%M%
keyword in
file.
- -y type
type
is compared with the
SCCS
%Y%
keyword in
file.
- -v
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,
val
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
LC_CTYPE
determines the interpretation of text within file
as single- and/or multi-byte characters.
LC_MESSAGES
determines the language in which messages are displayed.
If
LC_CTYPE
or
LC_MESSAGES
is not specified in the environment or is set to
the empty string, the value of
LANG
is used as a default for each
unspecified or empty variable.
If
LANG
is not specified or is set to the empty string, a default of "C" (see
lang(5))
is used instead of
LANG.
If any internationalization variable contains an invalid setting,
val
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
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:
- 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
%Y%
does not match
-y
type
argument;
- 7
%M%
does not match
-m
name
argument;
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.
DIAGNOSTICS
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 earlier under
RETURN VALUE.
Use the
sccshelp(1)
command for explanations.
STANDARDS CONFORMANCE
val: SVID2, SVID3, XPG2, XPG3, XPG4
Printable version
