system establish - Establish a system configuration.
system establish [options] system_path [dest_config]
The system establish command combines the RCS libraries to the RCS
libraries in the parent configuration. Optionally it removes all the
working versions of files from the RCS libraries. It also defines a
status and a symbolic name for the files kept in the library. By
default also the read only access is defined for the complete system
RCS libraries that are defined as links to other configurations are
The command system info -r shows the parent configuration.
If the configuration should be combined into another configuration
than the parent one, use the parameter dest_config.
The command system info -R shows which RCS libraries that are defined
as links and which are defined as directories.
Before a configuration can be combined, it must be checked. The
command starts with check of the configuration. Together with the
option -a the command also does combine the configuration, not only
If -b option is used, every selected file will be combined into a file
branch in the destination RCS libraries. The file branch will be
created from the version copied when creating the work directory.
The CR directory (including Change Requests) is kept as is, CRs with
the state Rel get the symbolic name specified with the -n option, or
the default name if the -n option is not specified.
Specifies a system configuration or a subsystem in a system
configuration as a top of a directory structure which will be
If specified this configuration is used as destination instead of
the parent configuration.
Select the latest version of files whose number is less than or
equal to rev. If rev indicates a branch rather than a version,
the latest version on that branch is retrieved. If -r rev is
omitted, the latest version on the default branch is retrieved.
If rev is $, the command determines the version number from
keyword values in the working file. Otherwise, a version is
composed of one or more numeric or symbolic fields separated by
Select the latest version on the selected branch whose state is
set to state.
Select the latest version on the selected branch which was
checked in by the user with login name login.
Select files specified by the suffixes for RCS files. A nonempty
suffix matches any pathname ending in the suffix. An empty suffix
matches any pathname of the form RCS/file or path/RCS/file. The
-x option can specify a list of suffixes separated by /. For
example, -x ,v/ specifies two suffixes: ,v and the empty suffix.
If two or more suffixes are specified, they are tried in order
when looking for an RCS file; the first one that works is used
for that file. If no RCS file is found but an RCS file can be
created, the suffixes are tried in order to determine the new RCS
file's name. The default for suffixes is installation-dependent;
normally it is ,v/ for hosts like Unix that permit commas in file
names, and is empty (i.e. just the empty suffix) for other hosts.
Select the latest version on the selected branch whose checkin
date/time is less than or equal to date. The date and time may be
given in free format. The time zone LT stands for local time;
other common time zone names are understood. For more detail see
the co(1) command.
-a Do an "action" on the configuration, either combine the RCS
libraries or keep them. If not specified, only check if the
configuration can be combined. The default, is to do only check
of the configuration.
-k Keep the RCS directories, remove all working versions.
-K This only works together with -k. Do not remove the versions
after the selected version of each copied file, from the RCS
library (RCS/file,v). The default is to only save the selected
version of the file in the RCS library. Status and eventual name
are set on the selected version of the file.
-nrl This only works together with -k. Do not remove eventual lock
from each file, warning messages will be sent for this version of
the file. The option may be useful together with -k option, when
the locked version is a version that should be kept anyway.
Default is to remove the lock from the file version, and remove
the file version if it is not needed.
-nt Apply the command on only the specified directory, instead of the
complete directory tree, starting from the system_path specified.
-i Ask for each subsystem if it should be combined or not.
Specify a new symbolic name for all files in the new RCS library.
By default name is defined from the configuration name (example:
configuration 1.0-0. The name is R1_0_0).
Set read-write-execute access on the structure. By default the
"g-w" (group have no write acess) access is defined.
Specify a new state for the files in the new RCS library. By
default, state is defined to "Rel".
Specify a log message for the files checked in into the new RCS
library. By default, message is defined to "Released version".
-b Create a branch for each selected file when combining it into the
RCS_dest library. Files with status Unchanged will also be copied
into a branch in the destination RCS library.
-v List which files are processed.
-f Forces combining of a version, even if warnings are got during
the check step. Only file versions which do not have later
versions in the file can be combined. For example, a file with
version 1.3 can be combined only if the file version in the
destination directory is 1.2 or lower.
system establish -a -r R2_0_0 sys1/R2_0_0
copies all the file versions specified by the symbolic name R2_0_0
from the system configuration R2_0_0 to the parent system
ci(1), co(1), rcs(1), s_combine(1), s_rcsiniw(1), s_info(1),
Ivica Crnkovic, Elisabet de Waal