VAL(1)                                                                  VAL(1)



NAME
     val - validate SCCS file

SYNOPSIS
     val -
     val [-s] [-r SID] [-m name] [-y type] 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  s-1SCCS %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 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;



                                                                        Page 1

VAL(1)                                                                  VAL(1)



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

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 produce a core dump.



































                                                                        Page 2