|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
User Commands sccs-get(1)
NAME
sccs-get, get - retrieve a version of an SCCS file
SYNOPSIS
/usr/ccs/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 SCCS his-
tory 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 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 pri-
marily by the SCCS comb command (see
sccs-comb(1)). For users, -r is an
easier way to specify a version. The
-a option supersedes the -r option
when both are used.
-b Creates a new branch. Used with the
-e option to indicate that the new
SunOS 5.10 Last change: 1 Nov 1999 1
User Commands sccs-get(1)
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-tiRmeetrieves the latest version checked
in prior to the date and time indi-
cated 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 max-
imum 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 characters may
separate the various 2 digit com-
ponents. If white-space characters
occur, the date-time specification
must be quoted.
-e Retrieves 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 mes-
sage. Concurrent use of `get -e'
for different SIDs is allowed. How-
ever, get will not check out a ver-
sion of the file if a writable ver-
sion is present in the directory.
All SCCS file protections stored in
the s.file, including the release
ceiling, floor, and authorized user
SunOS 5.10 Last change: 1 Nov 1999 2
User Commands sccs-get(1)
list, are honored by `get -e'.
-g Gets the SCCS version ID, without
retrieving the version itself. Used
to verify the existence of a partic-
ular SID.
-Gnewname Uses newname as the name of the
retrieved version.
-i sid-list | -isid-listSpecifies 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.
-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.
-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 key-
word precedes the SID, and the line
SunOS 5.10 Last change: 1 Nov 1999 3
User Commands sccs-get(1)
of text.
-p Writes 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 Suppresses all output normally writ-
ten on the standard output. However,
fatal error messages (which always
go to the standard error) remain
unaffected.
-t Retrieves the most recently created
(top) delta in a given release (for
example: -r1).
/usr/ccs/bin/get
-r[sid] Retrieves 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
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
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.
SunOS 5.10 Last change: 1 Nov 1999 4
User Commands sccs-get(1)
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/ccs/bin/get except
that SID is mandatory.
-x sid-list | -xsid-listExcludes 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/ccs/bin/get
The output format for /usr/ccs/bin/get is as follows:
"%s\n%d lines\n", <SID>, <number of lines>
/usr/xpg4/bin/get
The output format for /usr/xpg4/bin/get is as follows:
"%s\n%d\n", <SID>, <number of lines>
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
text of the retrieved source.
SunOS 5.10 Last change: 1 Nov 1999 5
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% 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 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%%M% %I%
____________________________________________________________
%Y% Module type: value of the t flag in the s.file
____________________________________________________________
%Z% 4-character string: `@(#)', recognized by what
____________________________________________________________
SunOS 5.10 Last change: 1 Nov 1999 6
User Commands sccs-get(1)
ID String
The table below explains how the SCCS identification string
is determined for retrieving and creating deltas.
_________________________________________________________________________________________________________
| Determination of |
| SCCS 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| hR.mL (5) | hR.mL.(mB+1).1 |
| | | does not exist | | |
| R | - | Trunk succ. (6)| R.mL | R.mL.(mB+1).1 |
| | | in release > 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| R.L | R.L.(mB+1).1 |
| | | release > R | | |
| 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 exam-
ple, `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.10 Last change: 1 Nov 1999 7
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 com-
mand 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, LC_ALL,
LC_COLLATE, LC_CTYPE, LC_MESSAGES, 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
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
/usr/ccs/bin/get
SunOS 5.10 Last change: 1 Nov 1999 8
User Commands sccs-get(1)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWsprot |
|_____________________________|_____________________________|
/usr/xpg4/bin/get
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE 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 SCCS 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 SCCS
files, but the real user does not, only one file may be
named when using -e.
SunOS 5.10 Last change: 1 Nov 1999 9
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:24:44 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (5333 hits)
(openSUSE 10.2)
svn man page (5208 hits)
(FreeBSD 6.2)
adv_cap_autoneg man page (4870 hits)
(Solaris 10 11_06)
CPAN man page (4607 hits)
(Suse Linux 10.1)
ssh man page (4342 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (2874 hits)
(Solaris 10 11_06)
netcat man page (2717 hits)
(Suse Linux 10.1)
pprosetup man page (2487 hits)
(Solaris 10 11_06)
startproc man page (2471 hits)
(Suse Linux 10.1)
signal man page (2406 hits)
(Suse Linux 10.1)
|
Man Pages 
