GET(CP) XENIX System V GET(CP)
Name
get - Gets a version of an SCCS file.
Syntax
get [-rSID] [-ccutoff] [-ilist] [-xlist] [-aseq-no.] [-k]
[-e] [-l[p]] [-p] [-m] [-n] [-s] [-b] [-g] [-t] file ...
Description
get generates an ASCII text file from each named SCCS file
according to the specifications given by its options, which
begin with -. The arguments may be specified in any order,
but all options apply to all named SCCS files. If a
directory is named, get behaves as though each file in the
directory were specified as a named file, except that
nonSCCS files (last component of the pathname does not begin
with s.) and unreadable files are silently ignored. If a
name of - is given, the standard input is read; each line of
the standard input is taken to be the name of an SCCS file
to be processed. Again, nonSCCS files and unreadable files
are silently ignored.
The generated text is normally written into a file called
the g-file whose name is derived from the SCCS filename by
simply removing the leading s.; (see also Files).
Each of the options is explained below as though only one
SCCS file is to be processed, but the effects of any option
apply independently to each named file.
-rSID The SCCS IDentification string (SID) of the
version (delta) of an SCCS file to be retrieved.
-ccutoff cutoff date-time, in the form:
YY[MM[DD[HH[MM[SS]]]]]
No changes (deltas) to the SCCS file that were
created after the specified cutoff date-time are
included in the generated ASCII text file. Units
omitted from the date-time default to their
maximum possible values; that is, -c7502 is
equivalent to -c750228235959. Any number of
nonnumeric characters may separate the various 2
digit pieces of the cutoff date-time. This
feature allows you to specify a cutoff date in
the form: ``-c77/2/2 9:22:25''.
-e Indicates that the get is for the purpose of
editing or making a change (delta) to the SCCS
file via a subsequent use of delta(CP). The -e
option used in a get for a particular version
(SID) of the SCCS file prevents further gets for
Page 1 (printed 8/7/87)
GET(CP) XENIX System V GET(CP)
editing on the same SID until delta is executed
or the j (joint edit) flag is set in the SCCS
file (see admin(CP)). Concurrent use of get-e
for different SIDs is always allowed.
If the g-file generated by get with an -e option
is accidentally ruined in the editing process, it
may be regenerated by reexecuting the get command
with the -k option in place of the -e option.
SCCS file protection specified via the ceiling,
floor, and authorized user list stored in the
SCCS file (see admin(CP)) are enforced when the
-e option is used.
-b Used with the -e option to indicate that the new
delta should have an SID in a new branch. This
option is ignored if the b flag is not present in
the file (see admin(CP)) or if the retrieved
delta is not a leaf delta. (A leaf delta is one
that has no successors on the SCCS file tree.)
Note: A branch delta may always be created from a
nonleaf delta.
-ilist A list of deltas to be included (forced to be
applied) in the creation of the generated file.
The list has the following syntax:
<list> ::= <range> | <list> , <range>
<range> ::= SID | SID - SID
SID, the SCCS Identification of a delta, may be
in any form described in the SCCS chapter in the
XENIX Programmer's Guide.
-xlist A list of deltas to be excluded (forced not to be
applied) in the creation of the generated file.
See the -i option for the list format.
-k Suppresses replacement of identification keywords
(see below) in the retrieved text by their value.
The -k option is implied by the -e option.
-l[p] Causes a delta summary to be written into an l-
file. If -lp is used then an l-file is not
created; the delta summary is written on the
standard output instead. See Files for the
format of the l-file.
-p Causes the text retrieved from the SCCS file to
be written on the standard output. No g-file is
Page 2 (printed 8/7/87)
GET(CP) XENIX System V GET(CP)
created. All output that normally goes to the
standard output goes to file descriptor 2
instead, unless the -s option is used, in which
case it disappears.
-s Suppresses all output normally written on the
standard output. However, fatal error messages
(which always go to file descriptor 2) remain
unaffected.
-m Causes each text line retrieved from the SCCS
file to be preceded by the SID of the delta that
inserted the text line in the SCCS file. The
format is: SID, followed by a horizontal tab,
followed by the text line.
-n Causes each generated text line to be preceded
with the get.CP identification keyword value (see
below). The format is: get.CP value, followed by
a horizontal tab, followed by the text line.
When both the -m and -n options are used, the
format is: get.CP value, followed by a horizontal
tab, followed by the -m option generated format.
-g Suppresses the actual retrieval of text from the
SCCS file. It is primarily used to generate an
l-file, or to verify the existence of a
particular SID.
-t Used to access the most recently created (top)
delta in a given release (e.g., -r1), or release
and level (e.g., -r1.2).
-aseq-no. The delta sequence number of the SCCS file delta
(version) to be retrieved (see sccsfile(F)).
This option is used by the comb(CP) command; it
is not particularly useful and should be avoided.
If both the -r and -a options are specified, the
-a option is used. Care should be taken when
using the -a option in conjunction with the -e
option, as the SID of the delta to be created may
not be what you expect. The -r option can be
used with the -a and -e options to control the
naming of the SID of the delta to be created.
For each file processed, get responds (on the standard
output) with the SID being accessed and with the number of
lines retrieved from the SCCS file.
If the -e option is used, the SID of the delta to be made
appears after the SID accessed and before the number of
lines generated. If there is more than one named file or if
Page 3 (printed 8/7/87)
GET(CP) XENIX System V GET(CP)
a directory or standard input is named, each filename is
printed (preceded by a newline) before it is processed. If
the -i option is used included deltas are listed following
the notation ``Included''; if the -x option is used,
excluded deltas are listed following the notation
``Excluded''.
Identification Keywords
Identifying information is inserted into the text retrieved
from the SCCS file by replacing identification keywords with
their value wherever they occur. The following keywords may
be used in the text stored in an SCCS file:
Keyword Value
get.CP Module name: either the value of the m flag in the
file (see admin(CP)), or if absent, the name of
the SCCS file with the leading s. removed.
400.1 SCCS identification (SID) (400.1.0.0) of the
retrieved text.
400 Release.
1 Level.
0 Branch.
0 Sequence.
87/08/06 Current date (YY/MM/DD).
8/6/87 Current date (MM/DD/YY).
12:56:13 Current time (HH:MM:SS).
87/06/07 Date newest applied delta was created (YY/MM/DD).
6/7/87 Date newest applied delta was created (MM/DD/YY).
16:22:01 Time newest applied delta was created (HH:MM:SS).
Module type:
value of the t flag in the SCCS file (see
admin(CP)).
s.get.CP SCCS filename.
/x/doc/frozen/xenix/5.4/man/manCP/s.get.CP
Fully qualified SCCS filename.
The value of the q flag in the file (see admin(CP)).
467 Current line number. This keyword is intended for
identifying messages output by the program such as
``this shouldn't have happened'' type errors. It
is not intended to be used on every line to
provide sequence numbers.
@(#) The 4-character string @(#) recognizable by
what(C).
@(#)get.CP 400.1
A shorthand notation for constructing what(C)
strings for XENIX program files.
@(#)get.CP 400.1 = @(#)get.CP<horizontal-
tab>400.1
@(#) get.CP 400.1@(#)
Another shorthand notation for constructing
what(C) strings for nonXENIX program files. @(#)
get.CP 400.1@(#) = @(#) get.CP 400.1@(#)
Page 4 (printed 8/7/87)
GET(CP) XENIX System V GET(CP)
Files
Several auxiliary files may be created by get. These files
are known generically as the g-file, l-file, p-file, and z-
file. The letter before the hyphen is called the tag. An
auxiliary filename is formed from the SCCS filename: the
last component of all SCCS filenames must be of the form
s.module-name, the auxiliary files are named by replacing
the leading s with the tag. The g-file is an exception to
this scheme: the g-file is named by removing the s. prefix.
For example, s.xyz.c, the auxiliary filenames would be
xyz.c, l.xyz.c, p.xyz.c, and z.xyz.c, respectively.
The g-file, which contains the generated text, is created in
the current directory (unless the -p option is used). A g-
file is created in all cases, whether or not any lines of
text were generated by the get. It is owned by the real
user. If the -k option is used or implied, the g-file's
mode is 644; otherwise the mode is 444. Only the real user
need have write permission in the current directory.
The l-file contains a table showing which deltas were
applied in generating the retrieved text. The l-file is
created in the current directory if the -l option is used;
its mode is 444 and it is owned by the real user. Only the
real user need have write permission in the current
directory.
Lines in the l-file have the following format:
a. A blank character if the delta was applied;
* otherwise
b. A blank character if the delta was applied or
wasn't applied and ignored;
* if the delta wasn't applied and wasn't ignored
c. A code indicating a ``special'' reason why the
delta was or was not applied:
``I'': Included
``X'': Excluded
``C'': Cut off (by a -c option)
d. Blank
e. SCCS identification (SID)
f. Tab character
g. Date and time (in the form YY/MM/DD HH:MM:SS) of
creation
h. Blank
i. Login name of person who created delta
The comments and MR data follow on subsequent lines,
indented one horizontal tab character. A blank line
terminates each entry.
Page 5 (printed 8/7/87)
GET(CP) XENIX System V GET(CP)
The p-file is used to pass information resulting from a get
with an -e option along to delta. Its contents are also
used to prevent a subsequent execution of get with an -e
option for the same SID until delta is executed or the joint
edit flag, j, (see admin(CP)) is set in the SCCS file. The
p-file is created in the directory containing the SCCS file
and the effective user must have write permission in that
directory. Its mode is 644 and it is owned by the effective
user. The format of the p-file is: the gotten SID, followed
by a blank, followed by the SID that the new delta will have
when it is made, followed by a blank, followed by the login
name of the real user, followed by a blank, followed by the
date-time the get was executed, followed by a blank and the
-i option if it was present, followed by a blank and the -x
option if it was present, followed by a newline. There can
be an arbitrary number of lines in the p-file at any time;
no two lines can have the same new delta SID.
The z-file serves as a lock-out mechanism against
simultaneous updates. Its contents are the binary (2 bytes)
process ID of the command (i.e., get) that created it. The
z-file is created in the directory containing the SCCS file
for the duration of get. The same protection restrictions
as those for the p-file apply for the z-file. The z-file is
created mode 444.
See Also
admin(CP), delta(CP), help(CP), prs(CP), what(C),
sccsfile(F)
Diagnostics
Use help(CP) for explanations.
Notes
If the effective user has write permission (either
explicitly or implicitly) in the directory containing the
SCCS files, but the real user doesn't, then only one file
may be named when the -e option is used.
Page 6 (printed 8/7/87)