SYNOPSIS
       val -

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


DESCRIPTION
       The  val  utility shall determine whether the specified file is an SCCS
       file meeting the characteristics specified by the options.

OPTIONS
       The val utility  shall  conform  to  the  Base  Definitions  volume  of
       IEEE Std 1003.1-2001,  Section  12.2, Utility Syntax Guidelines, except
       that the usage of the '-' operand is not strictly as  intended  by  the
       guidelines (that is, reading options and operands from standard input).

       The following options shall be supported:

       -m  name
              Specify  a  name, which is compared with the SCCS %M% keyword in
              file; see get .

       -r  SID
              Specify a SID (SCCS Identification String), an SCCS  delta  num-
              ber.   A  check  shall  be  made to determine whether the SID is
              ambiguous (for example, -r 1 is ambiguous because it  physically
              does not exist but implies 1.1, 1.2, and so on, which may exist)
              or invalid (for example, -r 1.0 or -r 1.1.0 are invalid  because
              neither  case  can exist as a valid delta number). If the SID is
              valid and not ambiguous, a check  shall  be  made  to  determine
              whether it actually exists.

       -s     Silence the diagnostic message normally written to standard out-
              put for any error that is detected while processing  each  named
              file on a given command line.

       -y  type
              Specify  a  type, which shall be compared with the SCCS %Y% key-
              word in file; see get .


OPERANDS
       The following operands shall be supported:

       file   A pathname of an existing SCCS file. If exactly one file operand
              appears,  and it is '-' , the standard input shall be read: each
              line shall be independently processed as if it  were  a  command
              line  argument  list. (However, the line is not subjected to any
              of the shell word expansions, such  as  parameter  expansion  or
              quote removal.)


STDIN
              ables  for the precedence of internationalization variables used
              to determine the values of locale categories.)

       LC_ALL If set to a non-empty string value, override the values  of  all
              the other internationalization variables.

       LC_CTYPE
              Determine  the  locale  for  the  interpretation of sequences of
              bytes of text data as characters (for  example,  single-byte  as
              opposed to multi-byte characters in arguments and input files).

       LC_MESSAGES
              Determine  the  locale  that should be used to affect the format
              and contents of diagnostic messages written to  standard  error,
              and informative messages written to standard output.

       NLSPATH
              Determine the location of message catalogs for the processing of
              LC_MESSAGES .


ASYNCHRONOUS EVENTS
       Default.

STDOUT
       The standard output shall consist of informative messages about either:

        1. Each file processed

        2. Each command line read from standard input

       If the standard input is not used, for each  file  operand  yielding  a
       discrepancy, the output line shall have the following format:


              "%s: %s\n", <pathname>, <unspecified string>

       If standard input is used, a line of input shall be written before each
       of the preceding lines for files containing discrepancies:


              "%s:\n", <input line>

STDERR
       Not used.

OUTPUT FILES
       None.

EXTENDED DESCRIPTION
       None.

EXIT STATUS
       The 8-bit code returned by val shall be a disjunction of  the  possible

       Note that val can process two or more files on a given command line and
       can  process  multiple command lines (when reading the standard input).
       In these cases an aggregate code shall be returned: a logical OR of the
       codes generated for each command line and file processed.

CONSEQUENCES OF ERRORS
       Default.

       The following sections are informative.

APPLICATION USAGE
       Since  the val exit status sets the 0x80 bit, shell applications check-
       ing "$?" cannot tell if it terminated due to a missing file argument or
       receipt of a signal.

EXAMPLES
       In  a directory with three SCCS files- s.x (of t type "text"), s.y, and
       s.z (a corrupted file)-the following command could produce  the  output
       shown:


              val - <<EOF
              -y source s.x
              -m y s.y
              s.z
              EOF


              -y source s.x


                  s.x: %Y%, -y mismatch
              s.z


                  s.z: corrupted SCCS file

RATIONALE
       None.

FUTURE DIRECTIONS
       None.

SEE ALSO
       admin , delta , get , prs

COPYRIGHT
       Portions  of  this text are reprinted and reproduced in electronic form
       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the