The admin utility shall conform to the Base Definitions volume of
POSIX.1‐2017, Section 12.2, Utility Syntax Guidelines, except
that the -i, -t, and -y options have optional option-arguments.
These optional option-arguments shall not be presented as
separate arguments. The following options are supported:
-n Create a new SCCS file. When -n is used without -i, the
SCCS file shall be created with control information but
without any file data.
-i[name] Specify the name of a file from which the text for a
new SCCS file shall be taken. The text constitutes the
first delta of the file (see the -r option for the
delta numbering scheme). If the -i option is used, but
the name option-argument is omitted, the text shall be
obtained by reading the standard input. If this option
is omitted, the SCCS file shall be created with control
information but without any file data. The -i option
implies the -n option.
-r SID Specify the SID of the initial delta to be inserted.
This SID shall be a trunk SID; that is, the branch and
sequence numbers shall be zero or missing. The level
number is optional, and defaults to 1.
-t[name] Specify the name of a file from which descriptive text
for the SCCS file shall be taken. In the case of
existing SCCS files (neither -i nor -n is specified):
* A -t option without a name option-argument shall
cause the removal of descriptive text (if any)
currently in the SCCS file.
* A -t option with a name option-argument shall cause
the text (if any) in the named file to replace the
descriptive text (if any) currently in the SCCS
file.
-f flag Specify a flag, and, possibly, a value for the flag, to
be placed in the SCCS file. Several -f options may be
supplied on a single admin command line.
Implementations shall recognize the following flags and
associated values:
b Allow use of the -b option on a get command to
create branch deltas.
cceil Specify the highest release (that is, ceiling),
a number less than or equal to 9999, which may
be retrieved by a get command for editing. The
default value for an unspecified c flag shall
be 9999.
ffloor Specify the lowest release (that is, floor), a
number greater than 0 but less than 9999, which
may be retrieved by a get command for editing.
The default value for an unspecified f flag
shall be 1.
dSID Specify the default delta number (SID) to be
used by a get command.
istr Treat the ``No ID keywords'' message issued by
get or delta 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(1p)) are found in the text
retrieved or stored in the SCCS file. If a
value is supplied, the application shall ensure
that the keywords exactly match the given
string; however, the string shall contain a
keyword, and no embedded <newline> characters.
j Allow concurrent get 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 Specify a list of releases to which deltas can
no longer be made (that is, get -e against one
of these locked releases fails). Conforming
applications shall use the following syntax to
specify a list. Implementations may accept
additional forms as an extension:
<list> ::= a | <range-list>
<range-list> ::= <range> | <range-list>, <range>
<range> ::= <SID>
The character a in the list shall be equivalent
to specifying all releases for the named SCCS
file. The non-terminal <SID> in range shall be
the delta number of an existing delta
associated with the SCCS file.
n Cause 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 shall
serve as anchor points so that branch deltas
may later be created from them. The absence of
this flag shall cause skipped releases to be
nonexistent in the SCCS file, preventing branch
deltas from being created from them in the
future. During the initial creation of an SCCS
file, the n flag may be ignored; that is, if
the -r option is used to set the release number
of the initial SID to a value greater than 1,
null deltas need not be created for the
``skipped'' releases.
qtext Substitute user-definable text for all
occurrences of the %Q% keyword in the SCCS file
text retrieved by get.
mmod Specify the module name of the SCCS file
substituted for all occurrences of the %M%
keyword in the SCCS file text retrieved by get.
If the m flag is not specified, the value
assigned shall be the name of the SCCS file
with the leading '.' removed.
ttype Specify the type of module in the SCCS file
substituted for all occurrences of the %Y%
keyword in the SCCS file text retrieved by get.
vpgm Cause 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 validation program. (If this flag
is set when creating an SCCS file, the
application shall ensure that the m option is
also used even if its value is null.)
-d flag Remove (delete) the specified flag from an SCCS file.
Several -d options may be supplied on a single admin
command. See the -f option for allowable flag names.
(The llist flag gives a list of releases to be
unlocked. See the -f option for further description of
the l flag and the syntax of a list.)
-a login Specify a login name, or numerical group ID, to be
added to the list of users who may make deltas
(changes) to the SCCS file. A group ID shall be
equivalent to specifying all login names common to that
group ID. Several -a options 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, then anyone may add deltas.
If login or group ID is preceded by a '!', the users so
specified shall be denied permission to make deltas.
-e login Specify 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 options may be used on a single
admin command line.
-y[comment]
Insert the comment text into the SCCS file as a comment
for the initial delta in a manner identical to that of
delta. In the POSIX locale, omission of the -y option
shall result in a default comment line being inserted
in the form:
"date and time created %s %s by %s", <date>, <time>, <login>
where <date> is expressed in the format of the date
utility's %y/%m/%d conversion specification, <time> in
the format of the date utility's %T conversion
specification format, and <login> is the login name of
the user creating the file.
-m mrlist Insert the list of modification request (MR) numbers
into the SCCS file as the reason for creating the
initial delta in a manner identical to delta. The
application shall ensure that the v flag is set and the
MR numbers are validated if the v flag has a value (the
name of an MR number validation program). A diagnostic
message shall be written if the v flag is not set or MR
validation fails.
-h Check the structure of the SCCS file and compare the
newly computed checksum with the checksum that is
stored in the SCCS file. If the newly computed checksum
does not match the checksum in the SCCS file, a
diagnostic message shall be written.
-z Recompute the SCCS file checksum and store it in the
first line of the SCCS file (see the -h option above).
Note that use of this option on a truly corrupted file
may prevent future detection of the corruption.
