VAL(CP)                  XENIX System V                   VAL(CP)



     Name
          val - Validates an SCCS file.

     Syntax
          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 options, 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 options are defined as follows.  The effects of any
          option 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 val.CP keyword in file.

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






     Page 1                                           (printed 8/7/87)

     VAL(CP)                  XENIX System V                   VAL(CP)



          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 option

          bit 2 = Corrupted SCCS file

          bit 3 = Can't open file or file not SCCS

          bit 4 = SID is invalid or ambiguous

          bit 5 = SID does not exist

          bit 6 = , -y mismatch

          bit 7 = val.CP, -m mismatch

          Note that val can process two or more files on a given
          command line and in turn can process multiple command line
          (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(CP), delta(CP), get(CP), prs(CP)

     Diagnostics
          Use help(CP) for explanations.

     Notes
          val can process up to 50 files on a single command line.




















     Page 2                                           (printed 8/7/87)