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



NAME
     val - validate an 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 on 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
                 exist) or invalid (e. g., r1.0 or r1.1.0 are
                 invalid because neither 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.





                        Printed 11/19/92                   Page 1

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



     The 8-bit code returned by val is a disjunction of the pos-
     sible errors; it can be interpreted as a bit string where
     (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

     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 com-
     mand line and file processed.

SEE ALSO
     admin(1), delta(1), get(1), help(1, prs(1).

DIAGNOSTICS
     Use help(1) for explanations.

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



























 Page 2                 Printed 11/19/92