unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 val(1)								      val(1)




 NAME
      val - validate SCCS file

 SYNOPSIS
      val -

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

 DESCRIPTION
      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
      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 Release 11i: November 2000






 val(1)								      val(1)




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

 EXTERNAL INFLUENCES
    Environment Variables
      LC_CTYPE determines the interpretation of text within file as single-
      and/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
      Single-byte and multi-byte character code sets are supported.

 RETURN VALUE
      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
      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 Release 11i: November 2000






 val(1)								      val(1)




 SEE ALSO
      admin(1), delta(1), get(1), sccshelp(1), prs(1), sccsfile(4).

 STANDARDS CONFORMANCE
      val: SVID2, SVID3, XPG2, XPG3, XPG4

















































 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000