Content-type: text/html Man page of val

val

Section: User Commands (1)
Index Return to Main Contents
 

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:  XPG4, XPG4-UNIX

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

OPTIONS

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

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

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

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

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

NAME
SYNOPSIS
STANDARDS
OPTIONS
OPERANDS
DESCRIPTION
NOTES
EXIT STATUS
EXAMPLES
ENVIRONMENT VARIABLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:43:03 GMT, October 02, 2010