val(1)                              CLIX                              val(1)



  NAME

    val - Validates an SCCS file

  SYNOPSIS

    val -

    val [-s] [-rSID] [-mname] [-ytype] files

  FLAGS

    -s      Silences the diagnostic message normally generated on stdout for
            any error that is detected while processing each named file on a
            given command line.

    -rSID   Checks to determine if the SID is ambiguous or not valid.  If the
            SID value is valid and not ambiguous, a check is made to determine
            if it actually exists.  The argument value SID (SCCS
            identification string) is an SCCS delta number.  An example of an
            ambiguous SID is r1 because it physically does not exist but
            implies 1.1, 1.2, and so forth, which may exist.  An example of an
            invalid SID is -r1.0 or -r1.1.0 because neither case can exist as
            a valid delta number.

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

  DESCRIPTION

    The val command determines if the specified file is an SCCS file meeting
    the characteristics specified by the optional argument list.  Arguments to
    the val command may appear in any order.  The arguments consist of flags
    that begin with a dash (-), and named files.

    The val command has a special argument, dash (-), which causes reading of
    stdin until an end-of-file condition is detected.  Each line read is
    independently processed as if it were a command line argument list.

    The val command generates diagnostic messages on stdout for each command
    line and file processed.  In addition, the val command returns a single
    8-bit code upon exit as described below.

    Note that the val command can process two or more files on a given command
    line and in turn can process multiple command lines (when reading stdin).
    The return in these cases is an aggregate code made up of a logical OR of
    the codes generated for each command line and file processed.




  2/94 - Intergraph Corporation                                              1

  val(1)                              CLIX                              val(1)



  EXAMPLES

    To validate the SCCS file test.c.s, enter:

    val test.c.s


  CAUTIONS

    The val command can process up to 50 files on a single command line.  Any
    number above 50 will produce a core dump.

  DIAGNOSTICS

    Use help for explanations.

  EXIT VALUES

    The 8-bit code returned by the val command is a disjunction of the
    possible errors, in other words, the code 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 flag argument.

    bit 2   Corrupted SCCS file.

    bit 3   Cannot open file or file not SCCS.

    bit 4   SID is not valid or ambiguous.

    bit 5   SID does not exist.

    bit 6   %Y%, -y mismatch.

    bit 7   %M%, -m mismatch.

  RELATED INFORMATION

    Commands: admin(1), delta(1), get(1), prs(1), help(1)












  2                                              Intergraph Corporation - 2/94