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.

The following options are supported:

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

-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;however, 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.

-asequence

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 supersedes -r when both are used.

-c date-time | -cdate-time

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. 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 components. If white-space characters occur, the date-time specification must be quoted.

-Gnewname

Use newname as the name of the retrieved version.

-i sid-list | -isid-list

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.

/usr/ccs/bin/get

/usr/xpg4/bin/get

/usr/ccs/bin/get

/usr/xpg4/bin/get

ID Keywords

ID String

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

See attributes(5) for descriptions of the following attributes:

/usr/ccs/bin/get

/usr/xpg4/bin/get

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), XPG4(5)

Use the SCCS help command for explanations (see 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.