VAL(1)                                                     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 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
                       s-1SCCS %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
          possible errors, i. e., can be interpreted as a bit string



     Page 1                                        (last mod. 8/20/87)

     VAL(1)                                                     VAL(1)



          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.

     SEE ALSO
          admin(1), delta(1), get(1), prs(1).
          help(1) in the User's Reference Manual.

     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.

     ORIGIN
          AT&T V.3
























     Page 2                                        (last mod. 8/20/87)