val(1) — sys5 — Apollo Domain/IX SR9.5



VAL(1)                   DOMAIN/IX SYS5                    VAL(1)



NAME
     val - validate SCCS file

USAGE
     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 effects 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 pos-
     sible 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 com-
     mand 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 gen-
     erated 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 com-
               mand line.

     -rSID     Check to see whether the value of SID (an SCCS



Printed 12/4/86                                             VAL-1



VAL(1)                   DOMAIN/IX SYS5                    VAL(1)



               delta number) is ambiguous or invalid.  For exam-
               ple, 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% key-
               word in file.

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

CAUTIONS
     Val can process up to 50 files on a single command line.

DIAGNOSTICS
     Use help(1) for explanations.

RELATED INFORMATION
     admin(1), delta(1), get(1), help(1), prs(1).






























VAL-2                                             Printed 12/4/86

Museum

Related Articles