s_rcsinfo



NAME

      system rcsinfo
       - Provide information about RCS libraries in a system configuration.


SYNOPSIS

      system rcsinfo [options] system_path


DESCRIPTION

      The command system rcsinfo displays different information about files
      placed in the RCS directories in the system (or subsystem), starting
      from the specified system path.  The command is based on the command
      rcsinfo.
      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:
      Locker

      "Name: names" is a whitespace-separated list of symbolic version
      names. It appears only if there are any symbolic names for the file
      version.

      "Locked by: Locker" appears only if the file version is locked.

    PARAMETERS
      system_path
           Specifies a system configuration or a subsystem in a system
           configuration as a path relative to /ipa/systems.

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

      -r[versions]
           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.

      -nr[versions]
           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.

      -l[lockers]
           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.

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

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

      -w[logins]
           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.

      -ddates
           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 -D options change the resulting output; only the description of
      each file is printed:

      -D   Instead of the ordinary output, print the description of each
           file.
           -D cannot be combined with -r, or -nr.

      The following options change the way in which the files are selected:

      -xsuffixes
           Select files in the same way as in checkout or in cocommand.

      -g grp
           Select files belonging to the group grp.
           If the option -g is used, the files parameter is ignored; don't
           use it with the -g option.

      -v   "Verbose": print directory names even if there are no matching
           files.
           The normal behaviour is to print directory names only for those
           directories where matching files are found.

      The following options define the output format:

      -T[SVANDC]
           Defines the column output format. The following option keywords
           are defined:
                    S  List State
                    V  List Version Number
                    A  List Author
                    N  List Symblic name (if defined)
                    D  List Version Date
                    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
           each version).
           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 the
           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.


EXAMPLES

      $ system rcsinfo -rR1_1_0 syst1/1.1-0

      prints all the files in the system configuration 1.1-0 of the system
      syst1 that have symbolic names R1_1_0.

      $system info -nrR1_1_0 syst1/1.1-0

      prints the names of all the files that do not have any version named
      R1_1_0.



      $ system rcsinfo -nsStable,Unchanged,Rel,Obsolete -r syst1/1.1-0

      prints all the files is the system configuration 1.1-0 of the system
      syst1 which latest versions do not have the state Stable, Unchanged,
      Rel, or Obsolete.


SEE ALSO

      rcsinfo(1), rlog(1)


AUTHOR

      Ivica Crnkovic, Mats Medin