1sccsfile(4) File Formats sccsfile(4)
2
6 sccsfile - format of an SCCS history file
7
9 An SCCS file is an ASCII file consisting of six logical parts:
10 checksum Character count used for error detection.
12 delta table Log containing version info and statistics about each
15 delta.
16 usernames Login names and/or group IDs of users who may add
19 deltas.
20 flags Definitions of internal keywords.
23 comments Arbitrary descriptive information about the file.
26 body the Actual text lines intermixed with control lines.
29 Each section is described in detail below.
33 Conventions
35 Throughout an SCCS file there are lines which begin with the ASCII SOH
36 (start of heading) character (octal 001). This character is hereafter
37 referred to as the control character, and will be represented as `^A'.
38 If a line described below is not depicted as beginning with the control
39 character, it cannot do so and still be within SCCS file format.
40 Entries of the form ddddd represent a five digit string (a number
43 between 00000 and 99999).
44 Checksum
46 The checksum is the first line of an SCCS file. The form of the line
47 is:
48 ^A hddddd
50 The value of the checksum is the sum of all characters, except those
54 contained in the first line. The ^Ah provides a magic number of (octal)
55 064001.
56 Delta Table
58 The delta table consists of a variable number of entries of the form:
59 ^As inserted/deleted/unchanged
61 ^Ad type sid yr/mo/da hr:mi:se username serial-number \
62 predecessor-sn
63 ^Ai include-list
64 ^Ax exclude-list
65 ^Ag ignored-list
66 ^Am mr-number
67 ...
68 ^Ac comments ...
69 ...
70 ^Ae
71 The first line (^As) contains the number of lines
76 inserted/deleted/unchanged respectively. The second line (^Ad) contains
77 the type of the delta (normal: D and removed: R), the SCCS ID of the
78 delta, the date and time of creation of the delta, the user-name corre‐
79 sponding to the real user ID at the time the delta was created, and the
80 serial numbers of the delta and its predecessor, respectively. The ^Ai,
81 ^Ax, and ^Ag lines contain the serial numbers of deltas included,
82 excluded, and ignored, respectively. These lines do not always appear.
83 The ^Am lines (optional) each contain one MR number associated with the
86 delta. The ^Ac lines contain comments associated with the delta.
87 The ^Ae line ends the delta table entry.
90 User Names
92 The list of user-names and/or numerical group IDs of users who may add
93 deltas to the file, separated by NEWLINE characters. The lines contain‐
94 ing these login names and/or numerical group IDs are surrounded by the
95 bracketing lines ^Au and ^AU. An empty list allows anyone to make a
96 delta.
97 Flags
99 Flags are keywords that are used internally (see sccs-admin(1) for more
100 information on their use). Each flag line takes the form:
101 ^Af flag
103 optional text
104 The following flags are defined in order of appearance:
108 ^Af t type-of-program Defines the replacement for the 12:24:17 ID
110 keyword.
111 ^Af v program-name Controls prompting for MR numbers in addition
114 to comments. If the optional text is present,
115 it defines an MR number validity checking pro‐
116 gram.
117 ^Af i Indicates that the `No id keywords' message is
120 to generate an error that terminates the SCCS
121 command. Otherwise, the message is treated as
122 a warning only.
123 ^Af b Indicates that the -b option may be used with
126 the SCCS get command to create a branch in the
127 delta tree.
128 ^Af m module-name Defines the first choice for the replacement
131 text of the sccsfile.4 ID keyword.
132 ^Af f floor Defines the "floor" release, that is, the
135 release below which no deltas may be added.
136 ^Af c ceiling Defines the "ceiling" release, that is, the
139 release above which no deltas may be added.
140 ^Af d default-sid The d flag defines the default SID to be used
143 when none is specified on an SCCS get command.
144 ^Af n The n flag enables the SCCS delta command to
147 insert a "null" delta (a delta that applies no
148 changes) in those releases that are skipped
149 when a delta is made in a new release (for
150 example, when delta 5.1 is made after delta
151 2.7, releases 3 and 4 are skipped).
152 ^Af j Enables the SCCS get command to allow concur‐
155 rent edits of the same base SID.
156 ^Af l lock-releases Defines a list of releases that are locked
159 against editing.
160 ^Af q user-defined Defines the replacement for the ID keyword.
163 ^Af e 0|1 The e flag indicates whether a source file is
166 encoded or not. A 1 indicates that the file is
167 encoded. Source files need to be encoded when
168 they contain control characters, or when they
169 do not end with a NEWLINE. The e flag allows
170 files that contain binary data to be checked
171 in.
172 Comments
175 Arbitrary text surrounded by the bracketing lines ^At and ^AT. The com‐
176 ments section typically will contain a description of the file's pur‐
177 pose.
178 Body
180 The body consists of text lines and control lines. Text lines do not
181 begin with the control character, control lines do. There are three
182 kinds of control lines: insert, delete, and end, represented by:
183 ^AI ddddd
185 ^AD ddddd
186 ^AE ddddd
187 respectively. The digit string is the serial number corresponding to
192 the delta for the control line.
193
195 sccs-admin(1), sccs-cdc(1), sccs-comb(1), sccs-delta(1), sccs-get(1),
196 sccs-help(1), sccs-prs(1), sccs-prt(1), sccs-rmdel(1), sccs-sact(1),
197 sccs-sccsdiff(1), sccs-unget(1), sccs-val(1), sccs(1), what(1)
198SunOS 5.11 30 Sep 2002 sccsfile(4)