val(1)                                                               val(1)




 NAME    [Toc]    [Back]
      val - validate SCCS file

 SYNOPSIS    [Toc]    [Back]
      val -

      val [-s] [-r SID] [-m name] [-y type] [-v] files

 DESCRIPTION    [Toc]    [Back]
      The val command reads one or more files to determine whether each file
      read is an SCCS file meeting the characteristics specified by the
      optional argument list.  Command-line options may appear in any order,
      and are described below.

    Options    [Toc]    [Back]
      The val command recognizes the following options and command-line
      arguments.  The effects of each option apply independently to each
      specified file.

           -s             Silent option.  Suppress diagnostic messages
                          normally generated on the standard output when an
                          error is encountered while processing any
                          specified file.

           -r SID         Check existence of revision SID in file where SID
                          (SCCS IDentification string) is an SCCS delta
                          number.  SID is first checked to ensure that it is
                          unambiguous and valid before checking file.  For
                          example, *-r1 is ambiguous because it physically
                          does not exist but implies 1.1, 1.2, etc., which
                          may exist; *-r1.0 and *-r1.1.0 are invalid because
                          they have a zero suffix which never appears in a
                          valid delta number.

           -m name        name is compared with the SCCS %M% keyword in
                          file.

           -y type        type is compared with the SCCS %Y% keyword in
                          file.

           -v             Verbose option.  Prints additional detailed
                          diagnostic messages on the standard output for any
                          corruption detected while processing each named
                          file.  The messages are intended for use with the
                          information contained in sccsfile(4) when fixing
                          the file.

           file           One or more SCCS files to be processed.  If - is
                          used as a file argument, val reads the standard
                          input until an end-of-file condition is
                          encountered.  Each line read is independently



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 val(1)                                                               val(1)




                          processed as if it were a command-line argument
                          list.

 EXTERNAL INFLUENCES    [Toc]    [Back]
    Environment Variables
      LC_CTYPE determines the interpretation of text within file as singleand/or
 multi-byte characters.

      LC_MESSAGES determines the language in which messages are displayed.

      If LC_CTYPE or LC_MESSAGES is not specified in the environment or is
      set to the empty string, the value of LANG is used as a default for
      each unspecified or empty variable.  If LANG is not specified or is
      set to the empty string, a default of "C" (see lang(5)) is used
      instead of LANG.

      If any internationalization variable contains an invalid setting, val
      behaves as if all internationalization variables are set to "C".  See
      environ(5).

    International Code Set Support    [Toc]    [Back]
      Single-byte and multi-byte character code sets are supported.

 RETURN VALUE    [Toc]    [Back]
      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  Interpretation
            0   Missing file argument;
            1   Unknown or duplicate option argument;
            2   Corrupt SCCS file;
            3   Cannot open file or file is not an SCCS file;
            4   SID is invalid or ambiguous;
            5   SID does not exist;
            6   %Y% does not match -y type argument;
            7   %M% does not match -m name argument;

      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.

 DIAGNOSTICS    [Toc]    [Back]
      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 earlier under RETURN VALUE.  Use the
      sccshelp(1) command for explanations.





 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 val(1)                                                               val(1)




 SEE ALSO    [Toc]    [Back]
      admin(1), delta(1), get(1), sccshelp(1), prs(1), sccsfile(4).

 STANDARDS CONFORMANCE    [Toc]    [Back]
      val: SVID2, SVID3, XPG2, XPG3, XPG4


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003