SCCSFILE(5,F) AIX Technical Reference SCCSFILE(5,F)
-------------------------------------------------------------------------------
sccsfile
PURPOSE
Contains the Source Code Control System (SCCS) information.
DESCRIPTION
The SCCS file is an ASCII file consisting of the following six logical parts:
checksum The sum value of all characters, except the characters in the first
line.
delta table Information about each delta including type, SCCS identification
(SID) date and time of creation, and comments.
user names Login names and numerical group IDs, or both, of users who are
allowed to add or remove deltas from the SCCS file.
flags Definitions of internal keywords.
comments Descriptive information about the file.
body The actual text lines intermixed with control lines.
There are lines throughout an SCCS file that begin with the ASCII SOH (start of
heading) character (octal 001). This character is called the control character
and is represented graphically as @ (at sign) in the following text. Any line
described in the following text not shown beginning with the control character
cannot begin with the control character.
The DDDDD entries represent a 5-digit string (a number from 00000 to 99999).
The following describes each logical part of an SCCS file.
Checksum
The checksum is the first line of an SCCS file. The value of the checksum is
the sum of all characters, except those of the first line. The @h designates a
magic number of 064001 octal (or 0x6801). The format of the line is:
@hDDDDD
Delta Table
The delta table consists of a variable number of entries such as:
@sDDDDD/DDDDD/DDDDD
@d type SCCS_ID yr/mo/da hh:mm:ss pgmr DDDDD DDDDD
Processed November 7, 1990 SCCSFILE(5,F) 1
SCCSFILE(5,F) AIX Technical Reference SCCSFILE(5,F)
@i DDDDD...
@x DDDDD...
@g DDDDD...
@m MR_number
.
.
.
@c comments...
.
.
.
@e
@s The first line, which contains the number of lines inserted or deleted or
unchanged, respectively.
@d The second line, which contains:
o The type of delta. D designates normal delta and R designates removed.
o The SCCS_ID (SID) of the delta.
o The date and time the delta was created.
o The login name that corresponds to the real user ID at the time the
delta was created.
o The serial numbers of the delta and its predecessor.
@i Contains the serial numbers of the deltas included. This line is optional.
@x Contains the serial numbers of deltas excluded. This line is optional.
@g Contains the serial numbers of the deltas ignored. This line is optional.
@m Optional lines, each one containing one modification request (MR) number
associated with the delta.
@c Comment lines associated with the delta.
@e Ends the delta table entry.
User Names
The list of login names and numerical group IDs, or both, of users who can add
deltas to the file, separated by new-line characters. The bracketing lines @u
and @U surround the lines containing the list. An empty list allows any user
to make a delta.
Flags
Processed November 7, 1990 SCCSFILE(5,F) 2
SCCSFILE(5,F) AIX Technical Reference SCCSFILE(5,F)
Flags are keywords used internally in the system. For more information about
their use, see the admin command in AIX Operating System Commands Reference.
The format of each flag line is:
"@f flag optional text"
The following flags are defined:
@ft type of program
@fv program name
@fi
@fb
@fm module name
@ff floor
@fc ceiling
@fd default-sid
@fn
@fj
@fl lock-releases
@fq user defined
The flags are used as follows:
b Allows the use of the -b option on the get command to cause a branch in the
delta tree.
c Defines the highest release number that can be retrieved by a get command
for editing. This release number must be less than or equal to 9999, and
its default value is 9999. This release number is called the ceiling
release number.
d Defines the default SID to be used when one is not specified with a get
command.
f Defines the lowest release number that can be retrieved by a get command for
editing. This release number must be between 0 and 9999, and its default
value is 1. This release number is called the floor release number.
i Controls the error warning message "No ID keywords". When this flag is not
present, this message is only a warning. When this flag is present, the
file is not used and the delta is not made.
j Causes the get command to allow concurrent edits of the same base SID.
l Defines a list of releases that cannot be edited with get using the -e flag.
m Defines the first choice for the replacement text of the sccsfile.5 identification
keyword.
Processed November 7, 1990 SCCSFILE(5,F) 3
SCCSFILE(5,F) AIX Technical Reference SCCSFILE(5,F)
n Causes the delta command to insert a delta that applies no changes for those
skipped releases when a delta for a new release is made. For example, delta
5.1 is made after delta 2.1, skipping releases 3 and 4. When this flag is
omitted, it causes skipped releases to be completely empty.
q Defines the replacement for the identification keyword.
t Defines the replacement for the identification keyword.
v Controls prompting for MR numbers in addition to comments. If optional text
is present, it defines an MR number validity checking program.
Comments
Typically, the comments section contains a description of the purpose of the
file. Bracketing lines @t and @T surrounding text designate the comments
section.
Body
The body section consists of control and text lines. Control lines begin with
the control character, text lines do not. There are three kinds of control
lines: insert, delete, and end, represented by:
@I DDDDD
@D DDDDD
@E DDDDD
respectively. The digit string is the serial number corresponding to the delta
for the control line.
RELATED INFORMATION
The admin, delta, get, and prs commands in AIX Operating System Commands
Reference.
Processed November 7, 1990 SCCSFILE(5,F) 4