NAME    [Toc]    [Back]

       val - Validates Source Code Control System (SCCS) files

SYNOPSIS    [Toc]    [Back]

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

       val -

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       val:  XCU5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

OPTIONS    [Toc]    [Back]

       Compares  the value identifier with the SCCS %M% identification
 keyword in file.  See  the  get  command  for  more
       information  on  the %M% keyword.  Specifies the SID (SCCS
       ID) of the file to be validated.  The SID  must  be  valid
       and  unambiguous.  If the SID is valid and unambiguous, it
       must exist.  Suppresses the error message normally written
       to  standard output.  Specifies a type to compare with the
       SCCS %Y% identification keyword in file.  See the get command
 for more information on the %Y% keyword.

OPERANDS    [Toc]    [Back]

       Specifies the pathname of an existing SCCS file.

              If  you specify no options and a - (dash) for file,
              val reads standard input and interprets  each  line
              of  standard  input  as  if  it were a command-line
              argument list consisting of  val  options  and  the
              name  of  a  file.   (However, the line is not subjected
 to any of the shell word expansions, such as
              parameter  expansion  or quote removal.) An End-ofFile
 key sequence terminates input.

DESCRIPTION    [Toc]    [Back]

       The val command reads files and  determines  whether  each
       specified file is an SCCS file meeting the characteristics
       specified by the options.

       The val command displays error messages to standard output
       for  each  file  processed, unless the -s option is specified.
  The val command also returns a  single  8-bit  code
       upon exit, described under EXIT STATUS.

NOTES    [Toc]    [Back]

       Since  the  val  exit status sets the 0x80 bit, you cannot
       check $?  to tell if it terminated due to a  missing  file
       argument or receipt of a signal.

EXIT STATUS    [Toc]    [Back]

       The  8-bit  code  indicates possible mismatches or errors.
       It is interpreted as a bit string, in which set bits (from
       left  to  right)  are interpreted as follows: Missing file
       argument.  Unknown  or  duplicate  option.   Damaged  SCCS
       file.   Cannot open file or file not SCCS.  SID is invalid
       or ambiguous.  SID does  not  exist.   %Y%,  -y  mismatch.
       %M%, -m mismatch.

       When  val  processes  two or more files on a given command
       line or multiple command lines (when reading the  standard
       input),  a  code  is  returned that is a logical OR of the
       codes generated for each file processed.

EXAMPLES    [Toc]    [Back]

       To determine if file s.test.c is an SCCS text file, enter:
       val -y text s.test.c

              or: val - -y text s.test.c <Ctrl-d>

              where <Ctrl-d> is the End-of-File key sequence.  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

ENVIRONMENT VARIABLES    [Toc]    [Back]

       The  following  environment variables affect the execution
       of val: Provides a default value for the internationalization
 variables that are unset or null. If LANG is unset or
       null, the corresponding value from the default  locale  is
       used.   If  any of the internationalization variables contain
 an invalid setting, the utility behaves as if none of
       the  variables  had  been  defined.  If set to a non-empty
       string value, overrides the values of all the other internationalization
  variables.  Determines the locale for the
       interpretation of sequences of bytes of text data as characters
  (for  example, single-byte as opposed to multibyte
       characters in arguments and input files).  Determines  the
       locale  for the format and contents of diagnostic messages
       written to standard error and informative messages written
       to  standard  output.   Determines the location of message
       catalogues for the processing of LC_MESSAGES.

SEE ALSO    [Toc]    [Back]

       Commands:  admin(1), cdc(1),  comb(1),  delta(1),  get(1),
       prs(1),  rmdel(1),  sact(1),  sccs(1),  sccsdiff(1),  sccshelp(1), unget(1), what(1)

       Files:  sccsfile(4)

       Standards:  standards(5)

       Programming Support Tools



                                                           val(1)