svcadm(1M)을 검색하려면 섹션에서 1M 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
get(1)
sccs-get(1) User Commands sccs-get(1)
NAME
sccs-get, get - retrieve a version of an SCCS 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 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
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 output) 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 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 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 indicated 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 characters can separate the vari‐
ous 2 digit components. If white-space
characters occur, the date-time specifi‐
cation 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 warn‐
ing 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 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 Gets the SCCS 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 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 key‐
word 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 standard 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 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/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 for‐
mat, 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 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 `−' sepa‐
rator 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", <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.
tab() box; cw(0.79i) |cw(4.71i) cw(0.79i) |lw(4.71i)
KeywordValue _ %%A%%T{ Shorthand notation for an ID line with data for
what(1): %%Z%%Y% %M% %I%%Z% T} _ %B%SID branch component _ %C%T{ Cur‐
rent line number. Intended for identifying messages output by the pro‐
gram such as ``this shouldn't have happened'' type errors. It is not
intended to be used on every line to provide sequence numbers. T} _
%D%Current date: yy/mm/dd _ %E%T{ Date newest applied delta was cre‐
ated: yy/mm/dd T} _ %F%SCCS s.file name _ %G%T{ Date newest applied
delta was created: mm/dd/yy T} _ %H%Current date: mm/dd/yy _ %I%T{ SID
of the retrieved version: %R%.%L%.%B%.%S% T} _ %%SID level component _
%M%T{ 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 T} _ %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%T{ Time the newest applied delta was created: hh:mm:ss T}
_ %W%T{ Shorthand notation for an ID line with data for what: %Z%%&;%
%I% T} _ %Y%T{ Module type: value of the t flag in the s.file T} _
%Z%T{ 4-character string: `@(#)', recognized by what T}
ID String
The table below explains how the SCCS identification string is deter‐
mined for retrieving and creating deltas.
tab() box; cw(0.92i) cw(0.92i) |cw(0.92i) |cw(1.38i) |cw(0.92i)
|cw(1.38i) lw(0.92i) |lw(0.92i) |lw(1.38i) |lw(0.92i) |lw(1.38i)
T{ Determination of SCCS Identification String T} _ SID (1) Specified-b
Option Used (2)Other ConditionsSID RetrievedSID of Delta to be Created
_ none (3)noR defaults to mRmR.mLmR.(mL+1) none (3)yesR defaults to
mRmR.mLmR.mL.(mB+1).1 RnoR > mRmR.mLR.1 (4) RnoR = mRmR.mLmR.(mL+1)
RyesR > mRmR.mLmR.mL.(mB+1).1 RyesR = mRmR.mLmR.mL.(mB+1).1 R−R < mR
and R does not existhR.mL (5)hR.mL.(mB+1).1 R−T{ Trunk succ. (6) in
release > R and R exists T}R.mLR.mL.(mB+1).1 R.LnoNo trunk
succ.R.LR.(L+1) R.LyesNo trunk succ.R.LR.L.(mB+1).1 R.L−Trunk succ. in
release ≥ RR.LR.L.(mB+1).1 R.L.BnoNo branch succ.R.L.B.mSR.L.B.(mS+1)
R.L.ByesNo branch succ.R.L.B.mSR.L.(mB+1).1 R.L.B.SnoNo branch
succ.R.L.B.SR.L.B.(S+1) R.L.B.SyesNo branch succ. R.L.B.SR.L.(mB+1).1
R.L.B.S−Branch succ.R.L.B.SR.L.(mB+1).1
(1) `R', `L', `B', and `S' are the `release', `level', `branch', and
`sequence' components of the SID, respectively; `m' means `maxi‐
mum'. Thus, for example, `R.mL' means `the maximum level number
within release R'; `R.L.(mB+1).1' means `the first sequence num‐
ber 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'.
(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(7) 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(7) for descriptions of the following attributes:
/usr/bin/get
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Availabilitydeveloper/build/make
/usr/xpg4/bin/get
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Availabilitydeveloper/xopen/xcu4 _ Interface Stability‐
Committed _ StandardSee standards(7).
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(5),
attributes(7), environ(7), standards(7)
DIAGNOSTICS
Use the sccs-help command for explanations of SCCS commands. See sccs-
help(1).
BUGS
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 can be named when using -e.
Solaris 11.4 22 Mar 2011 sccs-get(1)