sccs-cvt, sccscvt - convert SCCS history files between v4/v6
sccscvt [ options ] s.file1 .. s.filen
Sccscvt converts SCCS v4 history files (as introduced in
February 1977) into SCCS v6 history files (as introduced in
August 2011) and vice versa.
The first line, containing the SCCS magic number and the checksum
is converted to the format that is appropriate. The time format in the delta
table is converted by either removing the SCCS v6 extensions
or by adding time zone information by assuming that all time stamps are from
the local time zone. When converting from SCCS v6 to
SCCS v4, the enhanced time stamp data is retained as the first
delta comment line in a delta block.
SID specific SCCS v6 enhancements are converted into
special delta comment to prevent information loss when converting to
SCCS v4.
The SCCS v6 enhancements that are between the
SCCS v4 flags indicated by ^Af and the SCCS comment
block that is bracketed between ^At and ^AT are untouched as
these enhancements are not flagged by historic SCCS versions and retained by
historic SCCS versions when a history file is modified.
If a file argument refers to a directory, the directory is scanned
for file names that start with ``s.'' and examines all these files.
This program is a SCHILY extension that does not exist in
historic sccs implementations.
- -d
- When converting from SCCS v6 to SCCS v4,
discard the extended SCCS v6 meta data instead of converting
it into special degenerated delta comments.
- -k
- -keep
- Keep the original history file as o.file. When this option
is missing, the original file is replaced by the converted file.
- -V4
- Convert a SCCS v6 history file into a SCCS v4
history file.
- -V6
- Convert a SCCS v4 history file into a SCCS v6
history file.
- -help
- Prints a short summary of the sccscvt options and exists.
- -Nbulk-spec
- Processes a bulk of SCCS history files. This option allows to do an
efficient mass processing of SCCS history files.
The bulk-spec parameter is composed from an optional
list of flag parameters followed by an optional path
specifier.
The following flag types are supported:
- none
The following path specifier types are supported:
- -N
- The file name parameters to the sccscvt command are not
s.filename files but the names of the g-files. The
s.filename names are automatically derived from the g-file names by
prepending s. to the last path name component. Both,
s.filename and the g-file are in the same directory.
- -Ns.
- The file name parameters to the sccscvt command are
s.filename files. The the g-files names are automatically derived
by removing s. from the beginning of last path name component of
the s.filename. Both, s.filename and the g-file are in the
same directory.
- -Ndir
- The file name parameters to the sccscvt command are not
s.filename files but the names of the g-files. The
s.filename names are put into directory dir, the names are
automatically derived from the g-file names by prepending
dir/s. to the last path name component.
- -Ndir/s.
- The file name parameters to the sccscvt command are
s.filename files in directory dir. The the g-files names are
automatically derived by removing dir/s. from the beginning
of last path name component of the s.filename.
A typical value for dir is SCCS.
In order to overcome the limited number of exec(2)
arguments, it is recommended to use `−' as the file name
parameter for sccscvt(1) and to send a list of path names to
- -V
- -version
- --version
- Prints the sccscvt version number string and exists.
See environ(5) for descriptions of the following
environment variables that affect the execution of sccscvt(1):
LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, and
NLSPATH.
- SCCS_NO_HELP
- If set, sccscvt(1) will not automatically call help(1) with
the SCCS error code in order to print a more helpful error message.
Scripts that depend on the exact error messages of SCCS commands should
set the environment variable SCCS_NO_HELP and set LC_ALL=C.
- TZ
- Used for the timezone when converting between SCCS v4 and
SCCS v6.
The following exit values are returned:
- 0
- Successful completion.
- 1
- An error occurred.
- -1
- A wrong option or parameter was specified.
- s.file
- history file
- o.file
- saved original version of the history file
- x.file
- temporary copy of the s.file; renamed to the s.file after
completion.
- z.file
- temporary lock file contains the binary process id in host byte order
followed by the host name
sccs(1), sccs-admin(1), sccs-cdc(1), sccs-comb(1),
sccs-delta(1), sccs-get(1), sccs-help(1),
sccs-log(1), sccs-prs(1), sccs-prt(1),
sccs-rmdel(1), sccs-sact(1), sccs-sccsdiff(1),
sccs-unget(1), sccs-val(1), bdiff(1), diff(1),
what(1), sccschangeset(4), sccsfile(4),
attributes(5), environ(5), standards(5).
If a SCCS history file is converted from SCCS v4 to
SCCS v6 and there is no retained SCCS v6 timestamp
information in the delta comment, it may be a good idea to manually correct
time zone information.
sccscvt(1) was originally written by Joerg Schilling in 2011 and is still
maintained by Joerg Schilling.
A frequently updated source code for the SCCS suite is included in the
schilytools project and may be retrieved from the schilytools
project at Sourceforge at:
http://sourceforge.net/projects/schilytools/
The download directory is:
http://sourceforge.net/projects/schilytools/files/
Check for the schily-*.tar.bz2 archives.
Less frequently updated source code for the SCCS suite is
at:
http://sourceforge.net/projects/sccs/files/
Separate project informations for the SCCS project may be
retrieved from:
http://sccs.sf.net