admin(1) UNIX System V(Source Code Control System Utilities) admin(1)
NAME
admin - create and administer SCCS files
SYNOPSIS
admin [-n] [-i[name]] [-rrel] [-t[name]] [-fflag[flag-val]]
[-dflag[flag-val]] [-alogin] [-elogin] [-m[mrlist]] [-y[comment]]
[-h] [-z] files
DESCRIPTION
admin is used to create new SCCS files and change parameters of existing
ones. Arguments to admin, which may appear in any order, consist of
keyletter arguments (that begin with -) and named files (note that SCCS
file names must begin with the characters s.). If a named file does not
exist, it is created and its parameters are initialized according to the
specified keyletter arguments. Parameters not initialized by a keyletter
argument are assigned a default value. If a named file does exist,
parameters corresponding to specified keyletter arguments are changed,
and other parameters are left unchanged.
If a directory is named, admin behaves as though each file in the
directory were specified as a named file, except that non-SCCS files
(last component of the path name does not begin with s.) and unreadable
files are silently ignored. If a name of - is given, the standard input
is read; each line of the standard input is taken to be the name of an
SCCS file to be processed. Again, non-SCCS files and unreadable files
are silently ignored.
The keyletter arguments are listed below. Each argument is explained as
if only one named file were to be processed because the effect of each
argument applies independently to each named file.
-n This keyletter indicates that a new SCCS file is to be created.
-i[name]
The name of a file from which the text for a new SCCS file is to
be taken. The text constitutes the first delta of the file (see
-r keyletter for delta numbering scheme). If the -i keyletter is
used, but the file name is omitted, the text is obtained by
reading the standard input until an end-of-file is encountered.
If this keyletter is omitted, then the SCCS file is created empty.
Only one SCCS file may be created by an admin command on which the
i keyletter is supplied. Using a single admin to create two or
more SCCS files requires that they be created empty (no -i
keyletter). Note that the -i keyletter implies the -n keyletter.
-rrel The release into which the initial delta is inserted. This
keyletter may be used only if the -i keyletter is also used. If
the -r keyletter is not used, the initial delta is inserted into
release 1. The level of the initial delta is always 1 (by default
initial deltas are named 1.1).
10/89 Page 1
admin(1) UNIX System V(Source Code Control System Utilities) admin(1)
-t[name]
The name of a file from which descriptive text for the SCCS file
is to be taken. If the -t keyletter is used and admin is creating
a new SCCS file (the -n and/or -i keyletters also used), the
descriptive text file name must also be supplied. In the case of
existing SCCS files: (1) a -t keyletter without a file name
causes removal of the descriptive text (if any) that is currently
in the SCCS file, and (2) a -t keyletter with a file name causes
text (if any) in the named file to replace the descriptive text
(if any) that is currently in the SCCS file.
-fflag This keyletter specifies a flag, and, possibly, a value for the
flag, to be placed in the SCCS file. Several -f keyletters may be
supplied on a single admin command line. The allowable flags and
their values are:
b Allows use of the -b keyletter on a get command to create
branch deltas.
cceil The highest release (that is, ceiling): a number greater
than 0 but less than or equal to 9999 that may be retrieved
by a get command for editing. The default value for an
unspecified c flag is 9999.
ffloor
The lowest release (that is, floor): a number greater than
0 but less than 9999 that may be retrieved by a get command
for editing. The default value for an unspecified f flag is
1.
dSID The default delta number (SID) to be used by a get command.
i[str]
Causes the No id keywords (ge6) message issued by get or
delta to be treated as a fatal error. In the absence of
this flag, the message is only a warning. The message is
issued if no SCCS identification keywords [see get(1)] are
found in the text retrieved or stored in the SCCS file. If
a value is supplied, the keywords must exactly match the
given string. The string must contain a keyword, and no
embedded newlines.
j Allows concurrent get commands for editing on the same SID
of an SCCS file. This flag allows multiple concurrent
updates to the same version of the SCCS file.
llist A list of releases to which deltas can no longer be made
(get -e against one of these "locked" releases fails). The
list has the following syntax:
Page 2 10/89
admin(1) UNIX System V(Source Code Control System Utilities) admin(1)
<list> ::= <range> | <list> , <range>
<range> ::= RELEASE NUMBER | a
The character a in the list is equivalent to
specifying all releases for the named SCCS file.
n Causes delta to create a null delta in each of those
releases (if any) being skipped when a delta is made in a
new release (for example, in making delta 5.1 after delta
2.7, releases 3 and 4 are skipped). These null deltas serve
as anchor points so that branch deltas may later be created
from them. The absence of this flag causes skipped releases
to be non-existent in the SCCS file, preventing branch
deltas from being created from them in the future.
qtext User-definable text substituted for all occurrences of the
%Q% keyword in SCCS file text retrieved by get.
mmod module name of the SCCS file substituted for all occurrences
of the %M% keyword in SCCS file text retrieved by get. If
the m flag is not specified, the value assigned is the name
of the SCCS file with the leading s. removed.
ttype type of module in the SCCS file substituted for all
occurrences of %Y% keyword in SCCS file text retrieved by
get.
v[pgm]
Causes delta to prompt for Modification Request (MR) numbers
as the reason for creating a delta. The optional value
specifies the name of an MR number validity checking program
[see delta(1)]. This program will receive as arguments the
module name, the value of the type flag (see ttype above),
and the mrlist. (If this flag is set when creating an SCCS
file, the m keyletter must also be used even if its value is
null).
-dflag Causes removal (deletion) of the specified flag from an SCCS file.
The -d keyletter may be specified only when processing existing
SCCS files. Several -d keyletters may be supplied in a single
admin command. See the -f keyletter for allowable flag names.
(llist used with -d indicates a list of releases to be unlocked.
See the -f keyletter for a description of the l flag and the
syntax of a list.)
-alogin
A login name, or numerical UNIX System group ID, to be added to
the list of users who may make deltas (changes) to the SCCS file.
A group ID is equivalent to specifying all login names common to
that group ID. Several a keyletters may be used on a single admin
command line. As many logins or numerical group IDs as desired
may be on the list simultaneously. If the list of users is empty,
10/89 Page 3
admin(1) UNIX System V(Source Code Control System Utilities) admin(1)
then anyone may add deltas. If login or group ID is preceded by a
! they are to be denied permission to make deltas.
-elogin
A login name, or numerical group ID, to be erased from the list of
users allowed to make deltas (changes) to the SCCS file.
Specifying a group ID is equivalent to specifying all login names
common to that group ID. Several -e keyletters may be used on a
single admin command line.
-m[mrlist]
The list of Modification Requests (MR) numbers is inserted into
the SCCS file as the reason for creating the initial delta in a
manner identical to delta. The v flag must be set and the MR
numbers are validated if the v flag has a value (the name of an MR
number validation program). Diagnostics will occur if the v flag
is not set or MR validation fails.
-y[comment]
The comment text is inserted into the SCCS file as a comment for
the initial delta in a manner identical to that of delta.
Omission of the -y keyletter results in a default comment line
being inserted.
The -y keyletter is valid only if the -i and/or -n keyletters are
specified (that is, a new SCCS file is being created).
-h Causes admin to check the structure of the SCCS file [see
sccsfile(4)], and to compare a newly computed check-sum (the sum
of all the characters in the SCCS file except those in the first
line) with the check-sum that is stored in the first line of the
SCCS file. Appropriate error diagnostics are produced. This
keyletter inhibits writing to the file, nullifying the effect of
any other keyletters supplied; therefore, it is only meaningful
when processing existing files.
-z The SCCS file check-sum is recomputed and stored in the first line
of the SCCS file (see -h, above). Note that use of this keyletter
on a truly corrupted file may prevent future detection of the
corruption.
The last component of all SCCS file names must be of the form s.file.
New SCCS files are given mode 444 [see chmod(1)]. Write permission in
the pertinent directory is, of course, required to create a file. All
writing done by admin is to a temporary x-file, called x.file, [see
get(1)], created with mode 444 if the admin command is creating a new
SCCS file, or with the same mode as the SCCS file if it exists. After
successful execution of admin, the SCCS file is removed (if it exists),
and the x-file is renamed with the name of the SCCS file. This renaming
process ensures that changes are made to the SCCS file only if no errors
occurred.
Page 4 10/89
admin(1) UNIX System V(Source Code Control System Utilities) admin(1)
It is recommended that directories containing SCCS files be mode 755 and
that SCCS files themselves be mode 444. The mode of the directories
allows only the owner to modify SCCS files contained in the directories.
The mode of the SCCS files prevents any modification at all except by
SCCS commands.
admin also makes use of a transient lock file (called z.file), which is
used to prevent simultaneous updates to the SCCS file by different users.
See get(1) for further information.
FILES
x-file [see delta(1)]
z-file [see delta(1)]
bdiff Program to compute differences between the ``gotten''
file and the g-file [see get(1)].
SEE ALSO
bdiff(1), ed(1), delta(1), get(1), help(1), prs(1), what(1), sccsfile(4)
DIAGNOSTICS
Use the help command for explanations.
NOTES
If it is necessary to patch an SCCS file for any reason, the mode may be
changed to 644 by the owner allowing use of a text editor. You must run
admin -h on the edited file to check for corruption followed by an admin
-z to generate a proper check-sum. Another admin -h is recommended to
ensure the SCCS file is valid.
10/89 Page 5