Index for Section 1

Alphabetical listing for V

Bottom of page

val(1)
NAME
  val - Validates Source Code Control System (SCCS) files

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

  val -

STANDARDS
  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
  -m identifier
      Compares the value identifier with the SCCS %M% identification keyword
      in file.	See the get command for more information on the %M% keyword.

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

  -s  Suppresses the error message normally written to standard output.

  -y type
      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
  file
      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-of-
      File key sequence terminates input.

DESCRIPTION
  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
  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
  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:

  bit 0 (0x80)
      Missing file argument.

  bit 1 (0x40)
      Unknown or duplicate option.

  bit 2 (0x20)
      Damaged SCCS file.

  bit 3 (0x10)
      Cannot open file or file not SCCS.

  bit 4 (0x08)
      SID is invalid or ambiguous.

  bit 5 (0x04)
      SID does not exist.

  bit 6 (0x02)
      %Y%, -y mismatch.

  bit 7 (0x01)
      %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
   1.  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.

   2.  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
  The following environment variables affect the execution of val:

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

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

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

  LC_MESSAGES
      Determines the locale for the format and contents of diagnostic
      messages written to standard error and informative messages written to
      standard output.

  NLSPATH
      Determines the location of message catalogues for the processing of
      LC_MESSAGES.

SEE ALSO
  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

Index for Section 1

Alphabetical listing for V

Top of page