val(1)                   USER COMMANDS                     val(1)



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.

     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



                                                                1

val(1)                   USER COMMANDS                     val(1)



     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

     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.






























                                                                2