manpages.info - online man pages   

SunOS man pages : get (1)

User Commands                                         sccs-get(1)

NAME

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

SYNOPSIS

/usr/ccs/bin/get [ -begkmnpst ] [ -l [ p ] ] [ -ase- quence ] [ -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 ] ] [ -ase- quence ] [ -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: -b Create a new branch. Used with the -e option to indi- cate 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. SunOS 5.8 Last change: 1 Nov 1999 1 User Commands sccs-get(1) 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 ver- sion itself. Used to verify the existence of a partic- ular 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 key- word precedes the SID, and the line of text. -p Write 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 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" 6 Retrieve the latest version checked in prior to the date and time indicated by the date- time argument. date-time takes the form: SunOS 5.8 Last change: 1 Nov 1999 2 User Commands sccs-get(1) 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" 6 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 -r[sid] Retrieve 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 ver- sion 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. 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. SunOS 5.8 Last change: 1 Nov 1999 3 User Commands sccs-get(1) /usr/xpg4/bin/get -r sid | -rsid Same as for /usr/ccs/bin/get except that SID is manda- tory. -x sid-list | -xsid-list" 6 Exclude 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

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.8 Last change: 1 Nov 1999 4 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.8 Last change: 1 Nov 1999 5 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 | | Identification 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 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'. (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 SunOS 5.8 Last change: 1 Nov 1999 6 User Commands sccs-get(1) 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.

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 ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWsprot | |_____________________________|_____________________________| /usr/xpg4/bin/get ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWxcu4t | |_____________________________|_____________________________|

SEE ALSO

sccs(1), sccs-admin(1), sccs-delta(1), sccs-help(1), sccsprs(1) , sccs-prt(1), sccs-sact(1), sccs-unget(1), what(1), sccsfile(4), attributes(5), XPG4(5)

DIAGNOSTICS

Use the SCCS help command for explanations (see sccshelp(1) ). SunOS 5.8 Last change: 1 Nov 1999 7 User Commands sccs-get(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.8 Last change: 1 Nov 1999 8