User Commands sccs-get(1)
NAME
sccs-get, get - retrieve a version of an SCS file
SYNOPSIS
/usr/bin/get [-begkmnpst] [-l [p] [-asequence]
[-c date-time -cdate-time] [-Gg-file]
[-i sid-list -isid-list] [-r [sid]
[-x sid-list -xsid-list] s.filename...
/usr/xpg4/bin/get [-begkmnpst] [-l [p] [-asequence]
[-c date-time -cdate-time] [-Gg-file]
[-i sid-list -isid-list] [-r sid -rsid]
[-x sid-list -xsid-list] s.filename...
DESCRIPTION
The get utility retrieves a working copy from the SCS his-
tory file, according to the specified options.
For each s.filename argument, get displays the SCS delta
ID (SID) and number of lines retrieved.
If a directory name is used in place of the s.filename argu-
ment, the get command applies to all s.files in that direc-
tory. Unreadable s.files produce an error; processing con-
tinues 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 line.
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 out-
put) with the SID being accessed, and with the number of
lines retrieved from the s.file.
OPTIONS
The following options are supported:
-asequence Retrieves the version
corresponding to the indicated
delta sequence number. This
option is used primarily by
the SCS comb command (see
sccs-comb(1)). For users, -r
is an easier way to specify a
SunOS 5.11 Last change: 2 Jul 2007 1
User Commands sccs-get(1)
version. The -a option super-
sedes the -r option when both
are used.
-b Creates a new branch. Used
with the -e option to indicate
that the new delta should have
a SID in a new branch. Instead
of incrementing the level for
version to be checked in, get
indicates 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.
-c date-time -cdate-time Retrieves 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 indi-
cated date and time default to
their maximum possible values;
that is -c7502 is equivalent
to -c750228235959. Values of
yy in the range 69-99 refer to
the twentieth century. Values
in the range 00-68 refer to
the twenty-first century. Any
number of non-numeric charac-
ters can separate the various
2 digit components. If white-
space characters occur, the
date-time specification must
be quoted.
-e Retrieves a version for edit-
ing. With this option, get
places a lock on the s.file,
so that no one else can check
SunOS 5.11 Last change: 2 Jul 2007 2
User Commands sccs-get(1)
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. However, get
does not check out a version
of the file if a writable ver-
sion is present in the direc-
tory. All SCS file protec-
tions stored in the s.file,
including the release ceiling,
floor, and authorized user
list, are honored by `get -e'.
-g Gets the SCS version ID,
without retrieving the version
itself. Used to verify the
existence of a particular SID.
-Gnewname Uses newname as the name of
the retrieved version.
-i sid-list -isid-list Specifies a list of deltas to
include in the retrieved ver-
sion. 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.
-k Suppresses expansion of ID
keywords. -k is implied by the
-e.
-l[p] Retrieves 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.
SunOS 5.11 Last change: 2 Jul 2007 3
User Commands sccs-get(1)
-m Precedes 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 Precedes 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 Writes the text of the
retrieved version to the stan-
dard output. All messages that
normally go to the standard
output are written to the
standard error instead.
-s Suppresses all output normally
written on the standard out-
put. However, fatal error mes-
sages (which always go to the
standard error) remain unaf-
fected.
-t Retrieves the most recently
created (top) delta in a given
release (for example: -r1).
/usr/bin/get
-r[sid] Retrieves the version corresponding to the indi-
cated 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 del-
tas, the branch and sequence fields. For
instance, if 1.2 is the SID, 1 is the release,
and 2 is the level number. If 1.2.3.4 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 nor-
mally retrieves the highest release and level.
SunOS 5.11 Last change: 2 Jul 2007 4
User Commands sccs-get(1)
If the d flag is set to an SID in the s.file and
you omit the SID, get retrieves the default ver-
sion 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
release.
Similarly with branches, if you specify a
release, level and branch, get retrieves the
highest sequence in that branch.
/usr/xpg4/bin/get
-r sid -rsid Same as for /usr/bin/get except
that SID is mandatory.
-x sid-list -xsid-list Excludes 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.
OUTPUT
/usr/bin/get
The output format for /usr/bin/get is as follows:
"%%s\n%%d lines\n", ,
/usr/xpg4/bin/get
The output format for /usr/xpg4/bin/get is as follows:
"%%s\n%%d\n", ,
USAGE
Usage guidelines are as follows:
ID Keywords
In the absence of -e or -k, get expands the following ID
keywords by replacing them with the indicated values in the
SunOS 5.11 Last change: 2 Jul 2007 5
User Commands sccs-get(1)
text of the retrieved source.
SunOS 5.11 Last change: 2 Jul 2007 6
User Commands sccs-get(1)
Keyword Value
%%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 happened'' type errors. It is
not intended to be used on every line to pro-
vide sequence numbers.
%D% Current date: yy/mm/dd
%E% Date newest applied delta was created: yy/mm/dd
%F% SCS 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%
%% 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 prefix
%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: %Z%%&;% %I%
%Y% Module type: value of the t flag in the s.file
%Z% 4-character string: `@(#)', recognized by what
SunOS 5.11 Last change: 2 Jul 2007 7
User Commands sccs-get(1)
ID String
The table below explains how the SCS identification string
is determined for retrieving and creating deltas.
Determination of
SCS Identifica-
tion String
SID (1) Specified -b Option Used (2) Other Conditions SID Retrieved SID of Delta to be Created
none (3) no R defaults to mR mR.mL mR.(mL]1)
none (3) yes R defaults to mR mR.mL mR.mL.(mB]1).1
R no R > mR mR.mL R.1 (4)
R no R = mR mR.mL mR.(mL]1)
R yes R > mR mR.mL mR.mL.(mB]1).1
R yes R = mR mR.mL mR.mL.(mB]1).1
R - R < mR and R does not exist hR.mL (5) hR.mL.(mB]1).1
R - Trunk succ. (6) in release R.mL R.mL.(mB]1).1
> R and R exists
R.L no No trunk succ. R.L R.(L]1)
R.L yes No trunk succ. R.L R.L.(mB]1).1
R.L - Trunk succ. in release > R R.L R.L.(mB]1).1
R.L.B no No branch succ. R.L.B.mS R.L.B.(mS]1)
R.L.B yes No branch succ. R.L.B.mS R.L.(mB]1).1
R.L.B.S no No branch succ. R.L.B.S R.L.B.(S]1)
R.L.B.S yes No branch succ. R.L.B.S R.L.(mB]1).1
R.L.B.S - Branch succ. R.L.B.S R.L.(mB]1).1
(1) `R', `L', `B', and `S' are the `release', `level',
`branch', and `sequence' components of the SID,
respectively; `m' means `maximum'. Thus, for example,
`R.mL' means `the maximum level number within release
R'; `R.L.(mB]1).1' means `the first sequence number
on the new branch (that is, maximum branch number
plus one) of level L within release R'. Note: If the
SID specified is of the form `R.L', `R.L.B', or
`R.L.B.S', each of the specified components must
exist.
(2) The -b option is effective only if the b flag is
present in the file. An entry of `-' means
`irrelevant'.
SunOS 5.11 Last change: 2 Jul 2007 8
User Commands sccs-get(1)
(3) This case applies if the d (default SID) flag is not
present in the file. If the d flag is present in the
file, the SID obtained from the d flag is interpreted
as if it had been specified on the command line.
Thus, one of the other cases in this table applies.
(4) Forces creation of the first delta in a new release.
(5) `hR' is the highest existing release that is lower
than the specified, nonexistent, release R.
(6) Successor.
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment
variables that affect the execution of get: LANG, LCAL,
LCOLATE, LCTYPE, LCMESAGES, and NLSPATH.
FILES
``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
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
/usr/bin/get
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWsprot
/usr/xpg4/bin/get
SunOS 5.11 Last change: 2 Jul 2007 9
User Commands sccs-get(1)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWxcu4t
Interface Stability Standard
SEE ALSO
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(4), attributes(5), environ(5), standards(5)
DIAGNOSTICS
Use the SCS help command for explanations (see sccs-
help(1)).
BUGS
If the effective user has write permission (either expli-
citly or implicitly) in the directory containing the SCS
files, but the real user does not, only one file can be
named when using -e.
SunOS 5.11 Last change: 2 Jul 2007 10
|
