rcsinfo - Provide information about RCS library.
rcsinfo [options] [files]
The command rcsinfo displays different information about files placed
in the RCS directory.
In general, the following format of the printout is defined, one line
per file version:
filename version State: status Author: author Name: names Locked by:
"Name: names" is a whitespace-separated list of symbolic version
names. It appears only if there are any symbolic names for the file
"Locked by: Locker" appears only if the file version is locked.
Several options may be used to get different output format. See
options -c, -T, -D and -C.
Specifies which files should be looked for. You may specify
working file names, or versioned file names, i.e. "file" or
If no parameter is specified then the RCS directory in the
current directory is processed.
If you specify a directory (only one parameter) then the RCS
directory placed under that directory will be processed.
The following options are applied as search keys on each file, version
and limit the resulting output; only data for matching file,version
pairs are displayed:
Prints information about file versions given in the comma-
separated list versions of versions and ranges. A range rev1:rev2
means versions rev1 to rev2 on the same branch, :rev means
versions from the beginning of the branch up to and including
rev, and rev: means versions starting with rev to the end of the
branch containing rev. An argument that is a branch means all
versions on that branch. A range of branches means all versions
on the branches in that range. A branch followed by a . means the
latest versions in that branch. A bare -r with no versions means
the latest version on the default branch, normally the trunk.
Prints information about file versions that are not given in the
comma-separated list versions of versions and ranges. See -r for
a description of the list. -nr can be combined with -r to for
example look at the latest version of files which do not have the
versions (e.g. symbolic name) specified with -nr.
Print information about locked file versions. In addition, if
the comma-separated list lockers of login names is given, ignore
all locks other than those held by the lockers.
Print information about file versions whose state is equal to one
of the states given in the comma-separated list states. It cannot
be combined with the -ns option.
Print information about file versions whose state is not equal to
one of the states given in the comma-separated list states. It
cannot be combined with the -s option.
Print information about file versions checked in by users with
login names appearing in the comma-separated list logins. If
logins is omitted, the user's login is assumed.
Print information about file versions with a checkin date/time in
the ranges given by the semicolon-separated list of dates. A
range of the form d1<d2 or d2>d1 selects the versions that were
deposited between d1 and d2 exclusive. A range of the form <d or
d> selects all versions earlier than d. A range of the form d <
or >d selects all versions dated later than d. If < or > is
followed by = then the ranges are inclusive, not exclusive. A
range of the form d selects the single, latest version dated d or
earlier. The date/time strings d, d1, and d2 are in the free
format explained in co(1). Quoting is normally necessary,
especially for < and >. Note that the separator is a semicolon.
-b Print information about versions of the default branch.
rcsinfo prints the intersection of the file versions selected with the
options -r, -nr, -l, -s, -ns, -w, -d, and -b, with the exception that
-r, -nr and -b will first form a union that will then be intersected
with the other selections.
The following options change the way in which the files are selected:
Select files in the same way as in checkout or in co command.
The following options define the output format:
Defines the column output format. The following option keywords
V List Version Number
S List State
A List Author
D List Version Date
L List Locker's Name (L:userid)
N List Symbolic Name (if defined)
C List Title Description
Any combination of these keys may be used. If the -T option is
specified with no key, then only file names are listed (once for
Note that the C keyword should be used only when one version of
files are displayed (for example when the option -r is defined)
and when descriptions are one line long. Otherwise unpredictable
displays may occur. When printing several versions of a file,
use -C option instead.
-c This option is the same as the combination -TSVAN.
-C Writes the file description title after the list of versions. The
description is displayed in a separate line.
-D Instead of the ordinary output, print the description of each
-D cannot be combined with -r, or -nr.
-R Lists versioned filenames placed in the RCS directory.
-P Option used for internal purposes. Writes full pathname of the
files. The path specification corresponds to input path
specification (i.e if no path is specified in the RCS command,
only filenames will be presented. If the full path is specified
for the RCS directory, then the full pathname is listed).
Specifies the date output format, and specifies the default time
zone for date in the -ddates option. The zone should be empty, a
numeric offset, or the special string LT for local time. The
default is an empty zone, which uses the traditional format of
without any time zone indication and with slashes separating the
parts of the date; otherwise, times are output in 8601 format
with time zone indication. For example, if local time is January
11, 1990, 8pm Pacific Standard Time, eight hours west of , then
the time is output as follows:
option time output
-z 1990/01/12 04:00:00 (default)
-zLT 1990-01-11 20:00:00-08
-z+05:30 1990-01-12 09:30:00+05:30
$ rcsinfo -rR1_1_0
prints all the files that have symbolic names R1_1_0.
$ rcsinfo -nsStable,Unchanged,Rel,Obsolete -r
prints all the files which latest version do not have the state
Stable, Unchanged, Rel, or Obsolete.
Ivica Crnkovic, Mats Medin