val(1)                     DG/UX 4.30                      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 options and named files.

          Val has a special argument, -, that reads 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 listed below.  The effects of any option
          apply independently to each named file on the command line.

               -s              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
          possible errors, i. e., can be interpreted as a bit string



     Licensed material--property of copyright holder(s)         Page 1

     val(1)                     DG/UX 4.30                      val(1)



          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 = 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 - a logical OR of the codes generated for
          each command line and file processed - is returned.

     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 trigger an error.




























     Licensed material--property of copyright holder(s)         Page 2