


      ADMIN(1)                    (UNIX 5.0)                   ADMIN(1)



      NAME
           admin - create and administer SCCS files

      SYNTAX
           admin [-n] [-i[name]] [-rrel] [-t[name]]
           [-fflag[flag-val]] [-dflag[flag-val]]
           [-alogin] [-elogin] [-m[mrlist]] [-y[comment]] [-h] [-z]
           files

      DESCRIPTION
           Admin creates new SCCS files and changes 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 doesn't 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 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 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 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 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



      Page 1                                          (73 A2 02MT REV1)






      ADMIN(1)                    (UNIX 5.0)                   ADMIN(1)



                               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).

                -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 are 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
                               descriptive text (if any) 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) 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(1) command to create branch deltas.

                        cceil  The highest release (i.e., ``ceiling'').
                               This flag can have a value that is less
                               than or equal to 9999, which may be
                               retrieved by a get(1) command for
                               editing.  The default value for an
                               unspecified c flag is 9999.

                        ffloor The lowest release (i.e., ``floor'').
                               This flag can have a value that is
                               greater than 0 but less than 9999, which
                               may be retrieved by a get(1) command for
                               editing.  The default value for an



      Page 2                                          (73 A2 02MT REV1)






      ADMIN(1)                    (UNIX 5.0)                   ADMIN(1)



                               unspecified f flag is 1.

                        dSID   The default delta number (SID) to be
                               used by a get(1) command.

                        i      Causes the "No id keywords (ge6)"
                               message issued by get(1) or delta(1) 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.

                        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 deltas can
                               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
                               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(1).

                        mmod   Module name of the SCCS file substituted
                               for all occurrences of the %M% keyword
                               in SCCS file text retrieved by get(1).
                               If the m flag is not specified, the



      Page 3                                          (73 A2 02MT REV1)






      ADMIN(1)                    (UNIX 5.0)                   ADMIN(1)



                               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(1).

                        v[pgm] Causes delta(1) 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)).  (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 numerical 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 numerical group IDs, as
                               desired may be on the list
                               simultaneously.  If the list of users is
                               empty, then anyone may add 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.

                -y[comment]    The comment text is inserted into the



      Page 4                                          (73 A2 02MT REV1)






      ADMIN(1)                    (UNIX 5.0)                   ADMIN(1)



                               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

                               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]     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).  Diagnostics will
                               occur if the v flag is not set or MR
                               validation fails.

                -h             Causes admin to check the structure of
                               the SCCS file (see sccsfile(5)), 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 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 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.

      FILES
           The last component of all SCCS file pathnames must be of the
           form s.file-name.  New SCCS files are given mode 444 (see



      Page 5                                          (73 A2 02MT REV1)






      ADMIN(1)                    (UNIX 5.0)                   ADMIN(1)



           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-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, if present, is removed 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 have 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
           commands.

           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
           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 prevents simultaneous updates to the
           SCCS file by different users.  See get(1) for further
           information.

      SEE ALSO
           delta(1), ed(1), get(1), help(1), prs(1), what(1),
           sccsfile(4).
           Source Code Control System User's Guide in the ROS Utility
           Guide

      DIAGNOSTICS
           Use help(1) for explanations.


















      Page 6                                          (73 A2 02MT REV1)



