val(1)                                                               val(1)

NAME
     val - validate an SCCS file

SYNOPSIS
     val -

     val [-s] [-r SID] [-m name] [-y type] [--] file...

DESCRIPTION
     val (validate) determines if the specified file is an SCCS file meet-
     ing the characteristics specified by the optional argument list. Argu-
     ments to val may appear in any order.

     For val, the meaning of the argument - is different from its use with
     other SCCS commands. It allows val to read from the standard input
     instead of from the command line.

     val generates diagnostic messages on the standard output, and also
     returns an 8-bit code on exit.

OPTIONS
     The effects of each keyletter argument apply independently to each
     file named on the command line.

     -s       Suppresses the diagnostic message normally generated on the
              standard output for any error.

     -r SID   Checks whether the SID is ambiguous (e.g., -r 1 is ambiguous
              because it physically does not exist but implies 1.1, 1.2,
              etc., which may exist) or invalid (e.g., -r 1.0 or -r 1.1.0
              are invalid because neither 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.

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

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

     --       If the first filename begins with a dash (-), the end of the
              command-line options must be marked with --.

     The 8-bit code returned by val is a disjunction of the possible
     errors; it can be interpreted as a bit string in which the bits which
     are set are interpreted as follows, taken from left to right:









Page 1                       Reliant UNIX 5.44                Printed 11/98

val(1)                                                               val(1)

     bit 0
          = missing file name
     bit 1
          = unknown or duplicate option
     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

     val can process between two and 49 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.

LOCALE
     The language of the message texts is governed by the environment vari-
     able LCALL, LCMESSAGES or LANG.

     When the default is set, the system behaves as if it were not interna-
     tionalized, i.e. the message texts are in English. You must change one
     of these variables in order to change the language of the message
     texts.

     Detailed information on the dependencies of the environment variables
     and on internationalization in general can be found in the manual
     "Programmer's Guide: Internationalization - Localization". Refer also
     to environ(5) for information on setting the user environment.

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
















Page 2                       Reliant UNIX 5.44                Printed 11/98