val(1) — bsd

VAL(1)                               BSD                                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 that meets the
     characteristics specified by the optional argument list.  Options may
     appear in any order, as long as they are listed before filenames.  The
     effect of any option applies independently to each named file on the
     command line.

     val uses the dash (-) as a special argument, causing the standard input
     to be read 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 8-bit code returned by val is a disjunction of the possible errors,
     i.e., it 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
          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.

OPTIONS
     -s        Silence the diagnostic message normally generated on the
               standard output for any error detected while processing each
               named file on a given command line.

     -rSID     Check to see whether the value of SID (an SCCS delta number) is
               ambiguous or invalid.  For example, r1 is ambiguous because it
               physically does not exist but implies 1.1, 1.2, etc., which may
               exist.  Furthermore, 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, this option also checks to see if it
               actually exists.

     -mname    Compare the value of name with the SCCS %M% keyword in file.

     -ytype    Compare the value of type with the SCCS %Y% keyword in file.

BUGS
     val can process up to 50 files on a single command line.  Any number
     above 50 produces a core dump.

DIAGNOSTICS
     Use help(1) for explanations.

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

Museum