Windows PowerShell command on Get-command sccs-get

Manual Pages for UNIX Operating System command usage for man sccs-get

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 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 primarily by the SCCS 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 SCCS 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 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 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% 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%

____________________________________________________________

%% 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 SCCS identification string is determined for retrieving and creating deltas.

____________________________________________________________________________________________________________________

|___________________|____________________|_____________________________|_______________|____________________________|

|___________________|____________________|_____________________________|_______________|____________________________|

| 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 | - | 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 |

|___________________|____________________|_____________________________|_______________|____________________________|

(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, 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/bin/get

____________________________________________________________

| ATTRIBUTE TYPE | ATTRIBUTE VALUE |

|_____________________________|_____________________________|

| Availability | developer/build/make |

|_____________________________|_____________________________|

/usr/xpg4/bin/get

SunOS 5.11 Last change: 2 Jul 2007 9

User Commands sccs-get(1)

____________________________________________________________

| ATTRIBUTE TYPE | ATTRIBUTE VALUE |

|_____________________________|_____________________________|

| Availability | developer/xopen/xcu4 |

|_____________________________|_____________________________|

| Interface Stability | Committed |

|_____________________________|_____________________________|

| Standard | See standards(5). |

|_____________________________|_____________________________|

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 can be

named when using -e.

SunOS 5.11 Last change: 2 Jul 2007 10

Manual Pages for UNIX Operating System command usage for man sccs-get

User Commands sccs-get(1)

NAME

sccs-get, get - retrieve a version of an SCCS file

SYNOPSIS

DESCRIPTION

User Commands sccs-get(1)

User Commands sccs-get(1)

User Commands sccs-get(1)

User Commands sccs-get(1)

OUTPUT

USAGE

User Commands sccs-get(1)

User Commands sccs-get(1)

User Commands sccs-get(1)

User Commands sccs-get(1)

ATTRIBUTES

| ATTRIBUTE TYPE | ATTRIBUTE VALUE |

User Commands sccs-get(1)

| ATTRIBUTE TYPE | ATTRIBUTE VALUE |

SEE ALSO

BUGS