val(1)                           DG/UX 5.4.2                          val(1)


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 options and
       named files.

       val has a special argument, -, that reads 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 options are listed below.  The effects of any option apply
       independently to each named file on the command line.


            -s              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 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 possible
       errors, i. e., can be interpreted as a bit string where (moving from
       left to right) set bits are interpreted as follows:




Licensed material--property of copyright holder(s)                         1

val(1)                           DG/UX 5.4.2                          val(1)


              bit 0 = missing file argument
              bit 1 = unknown or duplicate option
              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 - a logical OR of
       the codes generated for each command line and file processed - is
       returned.

DIAGNOSTICS
       Use help(1) for explanations.

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

BUGS
       val can process up to 50 files on a single command line.  Any number
       above 50 will trigger an error.

































Licensed material--property of copyright holder(s)                         2