val(1)                                                     val(1)



     NAME
          val - validate SCCS file

     SYNOPSIS
          val -
          val [-mname] [-rSID] [-s] [-ytype] file...

     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 diag-
                      nostic message normally generated on the stan-
                      dard 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 ex-
                      ist) or invalid (e.g., -r1.0 or -r1.1.0 are in-
                      valid because neither case can exist as a valid
                      delta number).  If the SID is valid and not am-
                      biguous, a check is made to determine if it ac-
                      tually 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 pos-
          sible errors, i.e., can be interpreted as a bit string where



     April, 1990                                                     1

     val(1)                                                     val(1)



          (moving from left to right) set bits are interpreted as fol-
          lows:

             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 com-
          mand line and in turn can process multiple command lines
          (when reading the standard input).  In these cases an aggre-
          gate code is returned - a logical OR of the codes generated
          for each command line and file processed.

     EXAMPLES
               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 remain-
          ing files (in this case s.xyz) to determine if they meet the
          characteristics specified by the keyletter arguments associ-
          ated with them.

     FILES
          /usr/bin/val

     SEE ALSO
          admin(1), cdc(1), comb(1), delta(1), get(1), help(1),
          prs(1), rmdel(1), sact(1), sccs(1), sccsdiff(1), unget(1),
          what(1), sccsfile(4).
          ``SCCS Reference'' in A/UX Programming Languages and Tools,
          Volume 2.

     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.









     2                                                     April, 1990