NAME

val − validate SCCS file

SYNOPSIS

val -
val [-s] [-r SID] [-m name] [-y type] [-v] files

DESCRIPTION

val 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 can appear in any order, and are described below. 

Options

val 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 specifed file.

-rSID Check existence of revision SID in file where SID (S CCS 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. 

-mname name is compared with the SCCS %M% keyword in file.

-ytype 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

International Code Set Support

Single- and multi-byte character code sets are supported with the exception that multi-byte-character file names are not 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 help command for explanations (see help(1)).

SEE ALSO

admin(1), delta(1), get(1), help(1), prs(1), sccsfile(4). 

BUGS

val can process up to 50 files on a single command line.  Any number above 50 produces a fatal error. 

STANDARDS CONFORMANCE

val: SVID2, XPG2, XPG3

Hewlett-Packard Company  —  HP-UX Release 9.10: April 1995