VAL(1)                               SysV                               VAL(1)



NAME
     val - validate SCCS file

SYNOPSIS
     val -
     val [-s] [-rSID] [-mname] [-ytype] files

DESCRIPTION
     val determines if the specified file is an SCCS file meeting the
     characteristics specified by the option used.

     val has a special argument, -, which reads standard input until it
     reaches an end-of-file (EOF) condition.  Each line read is independently
     processed as if it were a command line argument list.

     val generates diagnostic messages on the standard output for each command
     line and file processed, and also returns a single 8-bit code on exit as
     described below.

OPTIONS
     -s        Silences the diagnostic message normally generated on the
               standard output for any error detected while processing each
               named file on a given command line.

     -rSID     The argument value SID (SCCS IDentification String) is an SCCS
               delta number.  val with this option c hecks to determine if the
               SID is ambiguous (for example, r1 is ambiguous because it
               physically does not exist but implies 1.1, 1.2, etc., which may
               exist) or invalid (for example, r1.0 or r1.1.0  are invalid
               because neither case can exist as a valid delta number).  If
               the SID is valid and not ambiguous, val with this option checks
               to determine if it actually exists.

     -mname    Compares the argument value name with the SCCS %M% keyword in
               file.

     -ytype    Compares the argument value type with the SCCS %Y% keyword in
               file.

     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 0 = missing file argument;
          bit 1 = unknown or duplicate keyletter argument;
          bit 2 = corrupted SCCS file;
          bit 3 = cannot open file or file not SCCS;
          bit 4 = SID is invalid or ambiguous;
          bit 5 = SID does not exist;
          bit 6 = %Y%, -y mismatch;
          bit 7 = %M%, -m mismatch;

NOTE
     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
     Use help(1) for explanations.

BUGS
     val can process up to 50 files on a single command line.  Any number
     above 50 will fail.

SEE ALSO
     admin(1), delta(1), get(1), prs(1), sccs(1).
     help(1) in Using Your SysV Environment.