val(1)                                                     val(1)



NAME
     val - validate SCCS file

SYNOPSIS
     val-

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

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

     file Specifies the name of the SCCS file to be validated.

     -mname
          Compares the name argument value with the SCCS %M%
          keyword in file.

     -rSID
          Checks to determine if the SCCS delta number, SID (SCCS
          IDentification String), is 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.

     -s   Silences the message normally generated on the standard
          output for any error that is detected while processing
          each named file on a given command line.

     -ytype
          Causes val to compare the argument value type with the
          SCCS %Y% keyword in 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.

     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 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:




January 1992                                                    1

val(1)                                                     val(1)



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

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

STATUS MESSAGES AND VALUES
     Use help for explanations.

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

FILES
     /usr/bin/val
          Executable file

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) in A/UX Programmer's Reference

     ``SCCS Reference'' in A/UX Programming Languages and Tools,
     Volume 2








2                                                    January 1992