


      VAL(1)                      (UNIX 5.0)                     VAL(1)



      NAME
           val - validate 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 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.




      Page 1                                          (73 A2 02MT REV1)






      VAL(1)                      (UNIX 5.0)                     VAL(1)



           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 keyletter argument;
                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%, -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).

      DIAGNOSTICS
           Use help(1) for explanations.

      BUGS
           If Val attempts to process more than 50 files on a single
           command line, it fails and the debugger will be activated.


























      Page 2                                          (73 A2 02MT REV1)



