val(1)                                                     val(1)



     NAME
          val - validate SCCS file

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

     DESCRIPTION
          val determines if the specified file is an SCCS file meeting
          the characteristics specified by the optional argument list.
          Arguments to val may appear in any order.  The arguments
          consist of keyletter arguments, which begin with a -, and
          named files.

          val has a special argument, -, which causes reading of the
          standard input until an end-of-file condition is detected.
          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 upon exit as described below.

          The keyletter arguments are defined as follows.  The effects
          of any keyletter argument apply independently to each named
          file on the command line.

             -s       The presence of this argument silences the
                      diagnostic message normally generated on the
                      standard output for any error that is detected
                      while processing each named file on a given
                      command line.

             -rSID    The argument value

                      SID (SCCS IDentification String) is an SCCS
                      delta number.  A check is made to determine if
                      the SID is ambiguous (e.g., -r1 is ambiguous
                      because it physically does not exist but implies
                      1.1, 1.2, etc., which may exist) or invalid
                      (e.g., -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, a check
                      is made to determine if it actually exists.

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

             -ytype   The argument value type is compared with the
                      SCCS %Y% keyword in file.

          The 8-bit code returned by val is a disjunction of the



     Page 1                                        (last mod. 1/16/87)

     val(1)                                                     val(1)



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

     EXAMPLE
               val -
               -yc -mabc s.abc
               -mxyz -ypll s.xyz

          first checks if file s.abc has a value c for its type flag
          and value abc for the module name flag.  Once processing of
          the first file is completed, val then processes the
          remaining files (in this case s.xyz) to determine if they
          meet the characteristics specified by the keyletter
          arguments associated with them.

     FILES
          /usr/bin/val

     SEE ALSO
          admin(1), delta(1), get(1), help(1), prs(1).

     DIAGNOSTICS
          Use help(1) for explanations.

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












     Page 2                                        (last mod. 1/16/87)