admin(1) admin(1)
NAME
admin - create and administer SCCS files
SYNOPSIS
admin [-alogin] [-dflag[flag-val]] [-elogin] [-fflag[flag-
val]] [-h] [-i[name]] [-m[mrlist]] [-n] [-rrel[.lev]]
[-t[name]] [-y[comment]] [-z] file...
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, which 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 initial-
ized 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 parame-
ters are left as is.
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 pathname does not be-
gin 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 as follows. Each is explained
as though only one named file is to be processed since the
effects of the arguments apply 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 con-
stitutes the first delta of the file (see -r
keyletter for delta numbering scheme). If the
i keyletter is used, but the file name is om-
itted, the text is obtained by reading the
standard input until an end-of-file is encoun-
tered. If this keyletter is omitted, then the
SCCS file is created empty (in this case, you
need to explicitly use the -n flag). 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
April, 1990 1
admin(1) admin(1)
keyletter). Note that the -i keyletter im-
plies the -n keyletter.
-rrel[.lev] rel is the release and lev is the level 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 default level of the initial
delta is 1 (by default initial deltas are
named 1.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 filename must also
be supplied. In the case of existing SCCS
files: (1) a -t keyletter without a filename
causes removal of descriptive text (if any)
currently in the SCCS file, and (2) a -t
keyletter with a filename causes text (if any)
in the named file to replace the descriptive
text (if any) currently in the SCCS file.
-fflag [flag-val]
This keyletter specifies a flag, and, possi-
bly, a value for the flag, to be placed in the
SCCS file. Several f keyletters may be sup-
plied on a single admin command line. The al-
lowable flags and their values are:
b Allows use of the -b keyletter on
a get(1) command to create branch
deltas.
cceil ceil is the highest release
(i.e., ``ceiling''), a number
less than or equal to 9999, which
may be retrieved by a get(1) com-
mand for editing. The default
value for an unspecified c flag
is 9999.
ffloor floor is the lowest release
(i.e., ``floor''), a number
greater than 0 but less than
9999, which may be retrieved by a
get(1) command for editing. The
default value for an unspecified
f flag is 1.
2 April, 1990
admin(1) admin(1)
dSID The default delta number (SID) to
be used by a get(1) command.
i[str] Causes the No id keywords (ge6)
message issued by get(1) or del-
ta(1) to be treated as a fatal
error. In the absence of this
flag, the message is only a warn-
ing. The message is issued if no
SCCS identification keywords (see
get(1)) are found in the text re-
trieved or stored in the SCCS
file. If str is supplied, the
keywords must exactly match the
given string. str must contain a
keyword and no embedded newlines.
j Allows concurrent get(1) commands
for editing on the same SID of an
SCCS file. This allows multiple
concurrent updates to the same
version of the SCCS file.
llist A list of releases to which del-
tas may no longer be made (get -e
against one of these "locked"
releases fails). The list has
the following syntax:
<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(1) to create a
``null'' delta in each of those
releases (if any) being skipped
when a delta is made in a new
release (e.g., 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 ab-
sence of this flag causes skipped
releases to be nonexistent in the
SCCS file, preventing branch del-
tas from being created from them
in the future.
April, 1990 3
admin(1) admin(1)
qtext User-definable text substituted
for all occurrences of the %Q%
keyword in SCCS file text re-
trieved by get(1).
mmod mod is the module name of the
SCCS file which is substituted
for all occurrences of the %M%
keyword in SCCS file text re-
trieved by get(1). If the m flag
is not specified, the value as-
signed 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(1).
v[pgm] Causes delta(1) to prompt for
Modification Request (MR) numbers
as the reason for creating a del-
ta. pgm specifies the name of an
MR number validity checking pro-
gram (see delta(1)). (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
on a single admin command. See the -f
keyletter for allowable flag names.
llist 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 numeric A/UX system group ID,
to be added to the list of users which 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 numeric group IDs, as desired
may be on the list simultaneously. If the list
of users is empty, then anyone may add deltas.
If login or group ID is preceded by a ! they
are to be denied permission to make deltas.
4 April, 1990
admin(1) admin(1)
-elogin A login name, or numeric 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.
-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(1). Omission of the
-y keyletter results in a default comment line
being inserted in the form:
date and time created YY/MM/DD HH:MM:SS
by login. If the comment contains spaces, you
must enclose the entire comment in double
quotes.
The -y keyletter is valid only if the -i and/or
-n keyletters are specified (i.e., a new SCCS
file is being created).
-m[mrlist] 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(1). 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). Error diagnostics will
appear if the v flag is not set or if MR vali-
dation fails.
-h Causes admin to check the structure of the SCCS
file (see sccsfile(4)), and to compare a newly
computed checksum (the sum of all the charac-
ters in the SCCS file except those in the first
line) with the checksum that is stored in the
first line of the SCCS file. Appropriate error
diagnostics are produced.
This keyletter inhibits writing on the file, so
that it nullifies the effect of any other
keyletters supplied, and is, therefore, only
meaningful when processing existing files.
-z The SCCS file checksum is recomputed and stored
in the first line of the SCCS file (see -h,
above).
Note that use of this keyletter on a truly cor-
rupted file may prevent future detection of the
April, 1990 5
admin(1) admin(1)
corruption.
The last component of all SCCS file names must
be of the form s.file-name. New SCCS files are
given mode 444 (see chmod(1)). Write permis-
sion 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-
name, (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 ensures that changes are made to
the SCCS file only if no errors occurred.
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 com-
mands.
If it should be necessary to patch an SCCS file for any rea-
son, the mode may be changed to 644 by the owner allowing
use of ed(1). Care must be taken! The edited file should
always be processed by an admin -h 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.
Admin also makes use of a transient lock file (called
z.file-name), which is used to prevent simultaneous updates
to the SCCS file by different users. See get(1) for further
information.
EXAMPLES
admin -ifile1 s.file1
creates a new file in SCCS format named s.file1, from file1.
FILES
/usr/bin/admin
SEE ALSO
delta(1), ed(1), get(1), help(1), prs(1), what(1),
sccsfile(4).
``SCCS Reference'' in A/UX Programming Languages and Tools,
Volume 2.
6 April, 1990
DIAGNOSTICS
Use help(1) for explanations.
April, 1990 7