SCCS-GET(1) General Commands Manual SCCS-GET(1)
sccs-get, get - retrieve a version of an SCCS file
/usr/sccs/get [ -begkmnpst ] [ -l[p]] [ -asequence ]
[ -cdate-time ] [ -Gg-file ] [ -isid-list ] [ -rsid ]
[ -xsid-list ] s.filename ...
get retrieves a working copy from the SCCS history file, according to
the specified options.
For each s.filename argument, get displays the SCCS delta ID (SID) and
number of lines retrieved.
If a directory name is used in place of the s.filename argument, the
get command applies to all s.files in that directory. Unreadable
s.files produce an error; processing continues with the next file (if
any). The use of `-' as the s.filename argument indicates that the
names of files are to be read from the standard input, one s.file per
The retrieved file normally has the same filename base as the s.file,
less the prefix, and is referred to as the g-file.
For each file processed, get responds (on the standard output) with the
SID being accessed, and with the number of lines retrieved from the
-b Create a new branch. Used with the -e option to indicate that
the new delta should have an SID in a new branch. Instead of
incrementing the level for version to be checked in, get indi-
cates in the p.file that the delta to be checked in should
either initialize a new branch and sequence (if there is no
existing branch at the current level), or increment the branch
component of the SID. If the b flag is not set in the s.file,
this option is ignored.
-e Retrieve a version for editing. With this option, get places a
lock on the s.file, so that no one else can check in changes to
the version you have checked out. If the j flag is set in the
s.file, the lock is advisory: get issues a warning message.
Concurrent use of `get -e' for different SIDs is allowed, how-
ever, get will not check out a version of the file if a writable
version is present in the directory. All SCCS file protections
stored in the s.file, including the release ceiling, floor, and
authorized user list, are honored by `get -e'.
-g Get the SCCS version ID, without retrieving the version itself.
Used to verify the existence of a particular SID.
-k Suppress expansion of ID keywords. -k is implied by the -e.
-m Precede each retrieved line with the SID of the delta in which
it was added to the file. The SID is separated from the line
with a TAB.
-n Precede each line with the %M% ID keyword and a TAB. When both
the -m and -n options are used, the ID keyword precedes the SID,
and the line of text.
-p Write the text of the retrieved version to the standard output.
All messages that normally go to the standard output are written
to the standard error instead.
-s Suppress all output normally written on the standard output.
However, fatal error messages (which always go to the standard
error) remain unaffected.
-t Retrieve the most recently created (top) delta in a given
release (for example: -r1).
-l[p] Retrieve a summary of the delta table (version log) and write it
to a listing file, with the `l.' prefix (called `l.file').
When -lp is used, write the summary onto the standard output.
Retrieve the version corresponding to the indicated delta
sequence number. This option is used primarily by the SCCS comb
command (see sccs-comb(1)); for users, -r is an easier way to
specify a version. -a supercedes -r when both are used.
Retrieve the latest version checked in prior to the date and
time indicated by the date-time argument. date-time takes the
form: yy[mm[dd[hh[mm[ss]]]]]. Units omitted from the indicated
date and time default to their maximum possible values; that is
-c7502 is equivalent to -c750228235959. Any number of non-
numeric characters may separate the various 2 digit components.
If white-space characters occur, the date-time specification
must be quoted.
Use newname as the name of the retrieved version.
Specify a list of deltas to include in the retrieved version.
The included deltas are noted in the standard output message.
sid-list is a comma-separated list of SIDs. To specify a range
of deltas, use a `-' separator instead of a comma, between two
SIDs in the list.
-rsid Retrieve the version corresponding to the indicated SID (delta).
The SID for a given delta is a number, in Dewey decimal format,
composed of two or four fields: the release and level fields,
and for branch deltas, the branch and sequence fields. For
instance, if 1.2 is the SID, 1 is the release, and 2 is the
level number. If 18.104.22.168 is the SID, 3 is the branch and 4 is
the sequence number.
You need not specify the entire SID to retrieve a version with
get. When you omit -r altogether, or when you omit both release
and level, get normally retrieves the highest release and level.
If the d flag is set to an SID in the s.file and you omit the
SID, get retrieves the default version indicated by that flag.
When you specify a release but omit the level, get retrieves the
highest level in that release. If that release does not exist,
get retrieves highest level from the next-highest existing
Similarly with branches, if you specify a release, level and
branch, get retrieves the highest sequence in that branch.
Exclude the indicated deltas from the retrieved version. The
excluded deltas are noted in the standard output message. sid-
list is a comma-separated list of SIDs. To specify a range of
deltas, use a `-' separator instead of a comma, between two SIDs
in the list.
In the absence of -e or -k, get expands the following ID keywords by
replacing them with the indicated values in the text of the retrieved
%A% Shorthand notation for an ID line with data for what(1):
%Z%%Y% %M% %I%%Z%
%B% SID branch component
%C% Current line number. Intended for identifying messages
output by the program such as ``this shouldn't have hap-
pened'' type errors. It is not intended to be used on
every line to provide sequence numbers.
%D% Current date: yy/mm/dd
%E% Date newest applied delta was created: yy/mm/dd
%F% SCCS s.file name
%G% Date newest applied delta was created: mm/dd/yy
%H% Current date: mm/dd/yy
%I% SID of the retrieved version: %R%.%L%.%B%.%S%
%L% SID level component
%M% Module name: either the value of the m flag in the s.file
(see sccs-admin(1)), or the name of the s.file less the
%P% Fully qualified s.file name
%Q% Value of the q flag in the s.file
%R% SID Release component
%S% SID Sequence component
%T% Current time: hh:mm:ss
%U% Time the newest applied delta was created: hh:mm:ss
%W% Shorthand notation for an ID line with data for what:
%Y% Module type: value of the t flag in the s.file
%Z% 4-character string: `@(#)', recognized by what.
``g-file'' version retrieved by get
l.file file containing extracted delta table info
p.file permissions (lock) file
z.file temporary copy of s.file
sccs(1), sccs-admin(1), sccs-delta(1), sccs-help(1), sccs-prs(1), sccs-
prt(1), sccs-sact(1), sccs-unget(1), what(1), sccsfile(5)
Use the SCCS help command for explanations (sccs-help(1)).
If the effective user has write permission (either explicitly or
implicitly) in the directory containing the SCCS files, but the real
user does not, only one file may be named when using -e.
28 June 1988 SCCS-GET(1)