NAME

checkpt − generate or translate SCCS Mergeable delta IDs for lists of files

SYNOPSIS

checkpt command args ...

DESCRIPTION

The checkpt command reads SCCS files and computes SCCS Mergeable IDs (SMIDs) for the deltas in each file using the Xerox Secure Hash Function.  A SMID consists of four eight-digit hexadecimal numbers.  At any point in time, there is a one-to-one correspondence between the SMIDs and SIDs for all the deltas in a given source file.  Source files that are manipulated by the Code Manager commands bringover(1) and resolve(1) may have their SIDs renumbered over time, but the SMIDs for the deltas do not change. 

The checkpt command defines a source file to be a file filename with a corresponding SCCS file found in ./SCCS/s.filename. 

USAGE

create [ -w workspace ] [ -k checkpoint-file ] [ -c comment ] [ -n ] [ -q ] files or dirs

Create the checkpoint file for the specified files and directories from within workspace and write the checkpoint to checkpoint-file. Given a directory name, checkpt create recursively looks for SCCS subdirectories and processes the SCCS history files found within them. 

Workspace is written into checkpoint-file for possible use by extract. 

The workspace argument is expected to specify a CodeManager workspace.  If it names a directory that is not a CodeManager workspace, then a warning is issued.  If the −w option is not specified, then the value of the shell environment variable CODEMGR_WS is used.  If CODEMGR_WS is not set and the current directory is contained within a workspace, the containing workspace is used. 

If the −k option is not specified, the checkpoint is written to the file checkpoint.out.  If checkpoint-file is specified as −, then the checkpoint is written to the standard output and the −q option is implied (to avoid mingling with the normal output). 

The −c option specifies a comment to be included in the checkpoint file.  If the −c option is not specified, checkpt prompts for a comment from the standard input. 

As each file is processed, a line is written to the standard output naming the file and the SID of the delta being checkpointed.  The −q option suppresses these messages. 

The −n option shows what would be done without actually writing checkpoint-file.

extract [ -w workspace ] [ -k checkpoint-file ] [ -d destination-dir] [ -n ] [ -q ]

Using sccs get, extract the appropriate deltas from the files listed in checkpoint-file and create a new hierarchy under destination-dir. The workspace argument specifies a Code Manager workspace that contains the SCCS history files from which to extract.  If workspace is not specified, the workspace stored in checkpoint-file is used. 

If the −k option is not specified, the file checkpoint.out is read.  If checkpoint-file is specified as −, then the checkpoint is read from the standard input. 

If the −d option is not specified, the current directory ("dot") is used.  The directory specified by destination-dir must either not exist or be empty. 

As each file is processed, a line is written to the standard output naming the file and the SID of the delta being extracted.  The −q option suppresses these messages. 

The −n option shows what would be done without actually extracting any files. 

If some of the required SCCS files are found but others are missing, the missing files are noted in warnings.  Rename support is not implemented. 

smid [ -w workspace ] [ -r SID ] [ -a ] file

Translate SID to a SMID for the specified file.  If SID is specified, just print the translation for that SID.  If the −a option is present, display the entire SMID = SID translation for the file; for example, each SMID and SID for each delta in the file. 

sid [ -w workspace ] [ -m "SMID" ] [ -a] file

Translate SMID to its equivalent SID for the specified file.  If SMID is specified, just print the translation for that SMID.  If the −a option is present, display the entire SID = SMID translation for the file.  For example; each SID and SMID for each delta in the file. 

Note that because a SMID contains three blank spaces between the four hex digits, it is necessary to enclose the SMID argument in quotation marks on the command line so that it is parsed as a single argument. 

SEE ALSO

bringover(1), checkpointfile(5), checkpttool(1), resolve(1), sccs(1)

Sun Release 4.1  —  Last change: 01 December 1992