VAL(1-SysV)         RISC/os Reference Manual          VAL(1-SysV)



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 gen-
                         erated 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 IDentifica-
                         tion 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.





                         Printed 1/15/91                   Page 1

VAL(1-SysV)         RISC/os Reference Manual          VAL(1-SysV)



     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 (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 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.

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

DIAGNOSTICS
     Use help(1) for explanations.

ERRORS
     val can process up to 50 files on a single command line.
     Any number above 50 will produce a core dump.

























 Page 2                  Printed 1/15/91