Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ val(1) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                                   val(1)



        _________________________________________________________________
        val                                                       Command
        validate SCCS file
        _________________________________________________________________


        SYNTAX

        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, -, 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 keyletter arguments are listed below:  The effects of any
        keyletter argument 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.




        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                                   val(1)



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

             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 - a
        logical OR of the codes generated for each command line and file
        processed - is returned.


        SEE ALSO

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


        DIAGNOSTICS

        Use help(1) for explanations.


        BUGS

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

















        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026