Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ val(1SCCS) — UTek 3.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

admin(1sccs)

delta(1sccs)

get(1sccs)

prs(1sccs)



VAL(1SCCS)              COMMAND REFERENCE              VAL(1SCCS)



NAME
     val - validate SCCS file

SYNOPSIS
     val -
     val [-s] [-rSID] [-mname] [-ytype] filenames

DESCRIPTION
     Val determines if the specified filename 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 dash (-), 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 upon exit as described below.

     The 8-bit code returned by val is a disjunction of the
     possible errors; for example, 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
     -mname  The argument value name is compared with the SCCS
             %M% keyword in filename.

     -rSID   The argument value SID (SCCS IDentification String)
             is an SCCS delta number.  A check is made to
             determine if the SID is ambiguous (for example, r1
             is ambiguous because it physically does not exist
             but implies 1.1, 1.2, and so forth, which may exist)



Printed 5/12/88                                                 1





VAL(1SCCS)              COMMAND REFERENCE              VAL(1SCCS)



             or invalid (for example, 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.

     -s      The presence of this argument 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.

     -ytype  The argument value type is compared with the SCCS
             %Y% keyword in filename.

DIAGNOSTICS
     Use sccshelp(1sccs) for explanations.

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

SEE ALSO
     admin(1sccs), delta(1sccs), get(1sccs), and prs(1sccs).


































Printed 5/12/88                                                 2





































































%%index%%
na:312,76;
sy:388,341;
de:729,2031;
op:2760,630;3774,804;
di:4578,192;
ca:4770,171;
se:4941,243;
%%index%%000000000130

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