[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

3.8 prs

The prs command (mnemonic: “print revision summary”) prints information about an SCCS file in a user-defined format. There are options for selecting which deltas are reported on; selection is possible by check-in time or by SID. The format of the output can also be specified on the command line. All parts of an SCCS file can be dumped with prs. Those parts which appear once per delta can be uniquely identified by SID or by time.

Typical uses for prs are


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

3.8.1 Basic Usage for prs

Here are some examples of the use of prs, with explanations of what they do.

prs s.myfile.c

Show information about all the versions of ‘myfile.c’.

prs SCCS

Show information about all the SCCS files in the directory ‘SCCS’.

prs -e -d:P: s.main.c | sort -u

Show which users have made changes to main.c.

prs -l -c`date +%y%m%d --date "last week"` SCCS

Examine all the SCCS files in the directory ‘SCCS’. Show any deltas that have been created since last week.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

3.8.2 Options for prs

-a

Include even removed deltas in the output. Removed deltas have a type "R", as output by the :DT: keyword.

-c[cc]YYMMDDHHMMSS

Specifies the time of the “cutoff”. When this option is given, the delta selected by prs is the last one checked in before the cutoff. As usual, any fields left unspecified in the cutoff are given the maximum legal value (for example, the seconds field defaults to 59). The fields can be separated by any non-numeric character, for example ‘-c97/11/02-11:25:42’.

As an extension specific to CSSC, if the argument contains more than twelve (12) digits, and the first four characters are all digits, it is assumed that a four-digit year form has been used. This means that you can say ‘-c1997/11/02-11:25:42’ to mean the same as the above.

In line with the X/Open CAE Specification, Commands and Utilities (version 2, September 1994, pages 588 and 361), if the century field is not given and the year is less than 69, it is assumed to be a year in the twenty-first century. The X/Open document does not mandate a four-digit year specifier, but it would not make sense to apply this rule if a four-digit year is specified. See section Year 2000 Issues.

This behaviour is usually not the one required, and hence the ‘-e’ or ‘-l’ options are specified too.

-dformat

This specifies the data format for the output. Because the default output format is sensible, this is typically used either in a shell script which will process the output further, or by a human to retrieve information which is not shown by default. See Data Keywords for the ‘-d’ option of prs for the various keywords that can be used. Any characters in the data format which are not part of a keyword are output as well.

If one specifies the ‘-d’ option, prs by default only gives information about the latest delta. To restore the default behavior of showing all the deltas, use the ‘-e’ option as well.

-e

Makes the ‘-c’ option select deltas created at or earlier than the specified time. Makes the ‘-r’ option select deltas before and including the one specified by the indicated SID.

-l

As the ‘-e’ option, but select only later deltas rather than earlier ones.

-rSID

Specifies the SID for which information is provided. If blank, the latest delta is selected.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

3.8.3 Data Keywords for the ‘-d’ option of prs


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

3.8.3.1 Global Keywords

These keywords expand to the same thing, no matter which version is being examined. Many of these are SCCS file flags (see section Flags).

:BD:

Emits the body of the SCCS file, that is, the part containing all the delta information. Note that since this is dumped verbatim, it contains control characters. If you want a more readable format, consider using the ‘-b’ option of prt (see section Options for prt).

:BF:

Indicates the setting (‘yes’ or ‘no’) of the branch flag.

:CB:

Indicates the value of the release number ceiling flag.

:Ds:

The default SID to check out (See Flags and get).

:F:

Name of the SCCS file.

:FB:

Indicates the value of the release floor boundary flag.

:FD:

File descriptive text (see section admin).

:FL:

List of SCCS file flags.

:J:

Value (‘yes’ or ‘no’) of the joint-edit flag.

:KF:

Value (‘yes’ or ‘no’) of the keyword-warning flag (see section admin).

:LK:

Value of the locked-releases flag.

:M:

The module name (the value of the ‘m’ flag).

:MF:

The value (‘yes’ or ‘no’) of the MR validation flag (see section delta).

:MP:

The value of the MR validation program flag (see section delta). This is usually the name of an executable file.

:ND:

The value of the null-delta (‘n’) flag (‘yes’ or ‘no’).

:Q:

The value of the (user-defined) Q flag (arbitrary one-line text).

:PN:

The full path name of the SCCS file.

:UN:

List of users authorised to make deltas to this file (one per line). This list can be modified with the use of the options ‘-a’ and ‘-e’ of admin; if this list is empty, any user is allowed to use delta on this file (subject to the usual file permissions checks made by the operating system). However, in this case the ‘UN’ data keyword somewhat curiously expands to ‘none’.

:Y:

Value of the module-type flag.

The ‘:BD:’, ‘:FD:’, ‘:FL:’ and ‘:UN:’ keywords from this section may expand to strings containing newlines.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

3.8.3.2 Version-specific Keywords

These keywords expand to data that is specific to a particular version.

:A:

Expands to ‘:Z::Y: :M: :I::Z:’, useful for what.

:B:

Branch number of SID

:C:

Comments for this delta. These may extend over several lines.

:D:

Date (yy/mm/dd) that this version was checked in. Expands to ‘:Dy:/:Dm:/:Dd:’. The year is always represented as two digits but is not ambiguous since the two-digit year is no later than 2068 (see section Year 2000 Issues).

:Dd:

Day-of-month on which the delta was checked in (two digits).

:Dg:

Sequence numbers of ignored deltas (separated by white space).

:DI:

Expands to ‘:Dn:/:Dx:/:Dg:’ (sequence numbers included/excluded/ignored).

:DL:

Expands to ‘:Li:/:Ld:/:Lu:’ (lines inserted/deleted/unchanged).

:Dm:

Month when this version as checked in (two digits).

:Dn:

Sequence numbers of included deltas (separated by white space).

:DP:

Sequence number of the delta that precedes this one.

:DS:

Sequence number of this delta.

:Dt:

Expands to ‘:DT: :I: :D: :T: :P: :DS: :DP:’.

:DT:

Delta type: ‘R’ (removed) or ‘D’ (normal).

:Dx:

Sequence numbers of excluded deltas (separated by white space).

:Dy:

Year when this version was checked in. The year is always represented as two digits but is not ambiguous since the two-digit year is no later than 2068 (see section Year 2000 Issues).

:GB:

The body for this version, as distinct from the body of the SCCS file itself, which is obtained with ‘:BD:’. Keyword expansion will be performed in the same way as if get had been used.

:I:

The SID of this version.

:L:

The level component of the SID (that is, the second number).

:Ld:

Number of lines deleted in this version, with respect to its predecessor.

:Li:

Number of lines inserted in this version, with respect to its predecessor.

:Lu:

Number of lines unchanged in this version, with respect to its predecessor.

:MR:

The MR numbers specified when this delta was created.

:P:

Perpetrator: the login name of the user who created this delta.

:R:

The release number of the SID (the first number).

:S:

The sequence number of the SID. Don’t confuse this with the delta sequence numbers (see section The Delta Table), which are internal identifiers for deltas which are output by the keywords :DI:, :Dn:, :Dx: and :Dg:.

:T:

Time that this version was checked in (‘:Th:::Tm:::Ts:’).

:Th:

Hours component of check-in time (‘:T:’).

:Tm:

Minutes component of check-in time (‘:T:’).

:Ts:

Seconds component of check-in time (‘:T:’).

:W:

Shorthand for ‘:Z::M:<TAB>:I:’, suitable for what (see section what).

:Z:

Expands to ‘@(#)’ (see section what).

The ‘:C:’, ‘:GB:’ and ‘:MR:’ keywords from this section may expand to strings containing newlines.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]

This document was generated by buildd user on October 11, 2013 using texi2html 1.82.