


      AAAADDDDMMMMIIIINNNN((((1111))))                    ((((UUUUNNNNIIIIXXXX 5555....0000))))                   AAAADDDDMMMMIIIINNNN((((1111))))



      NNNNAAAAMMMMEEEE
           admin - create and administer SCCS files

      SSSSYYYYNNNNTTTTAAAAXXXX
           aaaaddddmmmmiiiinnnn [----nnnn] [----iiii[name]] [----rrrrrel] [----tttt[name]]
           [----ffffflag[flag-val]] [----ddddffffllllaaaagggg[[[[ffffllllaaaagggg----vvvvaaaallll]]]]]]]]
           [----aaaallllooooggggiiiinnnn]]]] [----eeeellllooooggggiiiinnnn]]]] [----mmmm[[[[mmmmrrrrlllliiiisssstttt]]]]]]]] [----yyyy[[[[ccccoooommmmmmmmeeeennnntttt]]]]]]]] [----hhhh] [----zzzz]
           ffffiiiilllleeeessss

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           _A_d_m_i_n creates new SCCS files and changes parameters of
           existing ones.  Arguments to _a_d_m_i_n, 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 ssss....).  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, _a_d_m_i_n 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 ssss....) 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.

                ----nnnn             This keyletter indicates that a new SCCS
                               file is to be created.

                ----iiii[_n_a_m_e]       The _n_a_m_e 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 ----rrrr keyletter for delta
                               numbering scheme).  If the iiii 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 _a_d_m_i_n command on which the
                               iiii keyletter is supplied.  Using a single



      Page 1                                                   (9010-E)






      AAAADDDDMMMMIIIINNNN((((1111))))                    ((((UUUUNNNNIIIIXXXX 5555....0000))))                   AAAADDDDMMMMIIIINNNN((((1111))))



                               _a_d_m_i_n to create two or more SCCS files
                               requires that they be created empty (no
                               ----iiii keyletter).  Note that the ----iiii
                               keyletter implies the ----nnnn keyletter.

                ----rrrr_r_e_l          The _r_e_lease into which the initial delta
                               is inserted.  This keyletter may be used
                               only if the ----iiii keyletter is also used.
                               If the ----rrrr 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).

                ----tttt[_n_a_m_e]       The _n_a_m_e of a file from which
                               descriptive text for the SCCS file is to
                               be taken.  If the ----tttt keyletter is used
                               and _a_d_m_i_n is creating a new SCCS file
                               (the ----nnnn and/or ----iiii keyletters are also
                               used), the descriptive text file name
                               must also be supplied.  In the case of
                               existing SCCS files:  (1) a ----tttt keyletter
                               without a file name causes removal of
                               descriptive text (if any) currently in
                               the SCCS file, and (2) a ----tttt 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.

                ----ffff_f_l_a_g         This keyletter specifies a _f_l_a_g, and,
                               possibly, a value for the _f_l_a_g, to be
                               placed in the SCCS file.  Several ffff
                               keyletters may be supplied on a single
                               _a_d_m_i_n command line.  The allowable _f_l_a_gs
                               and their values are:

                        bbbb      Allows use of the ----bbbb keyletter on a
                               _g_e_t(1) command to create branch deltas.

                        cccc_c_e_i_l  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 _g_e_t(1) command for
                               editing.  The default value for an
                               unspecified cccc flag is 9999.

                        ffff_f_l_o_o_r 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 _g_e_t(1) command for
                               editing.  The default value for an



      Page 2                                                   (9010-E)






      AAAADDDDMMMMIIIINNNN((((1111))))                    ((((UUUUNNNNIIIIXXXX 5555....0000))))                   AAAADDDDMMMMIIIINNNN((((1111))))



                               unspecified ffff flag is 1.

                        dddd_S_I_D   The default delta number (SID) to be
                               used by a _g_e_t(1) command.

                        iiii      Causes the "No id keywords (ge6)"
                               message issued by _g_e_t(1) or _d_e_l_t_a(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
                               _g_e_t(1)) are found in the text retrieved
                               or stored in the SCCS file.

                        jjjj      Allows concurrent _g_e_t(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.

                        llll_l_i_s_t  A _l_i_s_t of releases to which deltas can
                               no longer be made (ggggeeeetttt ----eeee against one of
                               these ``locked'' releases fails).  The
                               _l_i_s_t has the following syntax:

                               <list> ::= <range> | <list> , <range>
                               <range> ::=    _R_E_L_E_A_S_E _N_U_M_B_E_R | aaaa

                               The character aaaa in the _l_i_s_t is
                               equivalent to specifying _a_l_l _r_e_l_e_a_s_e_s
                               for the named SCCS file.

                        nnnn      Causes _d_e_l_t_a(1) to create a ``null''
                               delta in each of those releases (if any)
                               being skipped when a delta is made in a
                               _n_e_w 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.

                        qqqq_t_e_x_t  User definable text substituted for all
                               occurrences of the %Q% keyword in SCCS
                               file text retrieved by _g_e_t(1).

                        mmmm_m_o_d   _M_o_dule name of the SCCS file substituted
                               for all occurrences of the %M% keyword
                               in SCCS file text retrieved by _g_e_t(1).
                               If the mmmm flag is not specified, the



      Page 3                                                   (9010-E)






      AAAADDDDMMMMIIIINNNN((((1111))))                    ((((UUUUNNNNIIIIXXXX 5555....0000))))                   AAAADDDDMMMMIIIINNNN((((1111))))



                               value assigned is the name of the SCCS
                               file with the leading ssss.... removed.

                        tttt_t_y_p_e  _T_y_p_e of module in the SCCS file
                               substituted for all occurrences of %Y%
                               keyword in SCCS file text retrieved by
                               _g_e_t(1).

                        vvvv[[[[_p_g_m] Causes _d_e_l_t_a(1) to prompt for
                               Modification Request (_M_R) numbers as the
                               reason for creating a delta.  The
                               optional value specifies the name of an
                               _M_R number validity checking program (see
                               _d_e_l_t_a(1)).  (If this flag is set when
                               creating an SCCS file, the mmmm keyletter
                               must also be used even if its value is
                               null.)

                ----dddd_f_l_a_g         Causes removal (deletion) of the
                               specified _f_l_a_g from an SCCS file.  The
                               ----dddd keyletter may be specified only when
                               processing existing SCCS files.  Several
                               ----dddd keyletters may be supplied on a
                               single _a_d_m_i_n command.  See the ----ffff
                               keyletter for allowable _f_l_a_g names.

                        llll_l_i_s_t  A _l_i_s_t of releases to be ``unlocked''.
                               See the ----ffff keyletter for a description
                               of the llll flag and the syntax of a _l_i_s_t.

                ----aaaa_l_o_g_i_n        A _l_o_g_i_n 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 _l_o_g_i_n names common to that group ID.
                               Several aaaa keyletters may be used on a
                               single _a_d_m_i_n command line.  As many
                               _l_o_g_i_ns, or numerical group IDs, as
                               desired may be on the list
                               simultaneously.  If the list of users is
                               empty, then anyone may add deltas.

                ----eeee_l_o_g_i_n        A _l_o_g_i_n 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 _l_o_g_i_n names
                               common to that group ID.  Several eeee
                               keyletters may be used on a single _a_d_m_i_n
                               command line.

                ----yyyy[_c_o_m_m_e_n_t]    The _c_o_m_m_e_n_t text is inserted into the



      Page 4                                                   (9010-E)






      AAAADDDDMMMMIIIINNNN((((1111))))                    ((((UUUUNNNNIIIIXXXX 5555....0000))))                   AAAADDDDMMMMIIIINNNN((((1111))))



                               SCCS file as a comment for the initial
                               delta in a manner identical to that of
                               _d_e_l_t_a(1).  Omission of the ----yyyy keyletter
                               results in a default comment line being
                               inserted in the form:

                               date and time created _Y_Y/_M_M/_D_D _H_H:_M_M:_S_S
                               by _l_o_g_i_n

                               The ----yyyy keyletter is valid only if the ----iiii
                               and/or ----nnnn keyletters are specified
                               (i.e., a new SCCS file is being
                               created).

                ----mmmm[_m_r_l_i_s_t]     The list of Modification Requests (_M_R)
                               numbers is inserted into the SCCS file
                               as the reason for creating the initial
                               delta in a manner identical to _d_e_l_t_a(1).
                               The vvvv flag must be set and the _M_R
                               numbers are validated if the vvvv flag has
                               a value (the name of an _M_R number
                               validation program).  Diagnostics will
                               occur if the vvvv flag is not set or _M_R
                               validation fails.

                ----hhhh             Causes _a_d_m_i_n to check the structure of
                               the SCCS file (see _s_c_c_s_f_i_l_e(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.

                ----zzzz             The SCCS file check-sum is recomputed
                               and stored in the first line of the SCCS
                               file (see ----hhhh, above).

                               Note that use of this keyletter on a
                               truly corrupted file may prevent future
                               detection of the corruption.

      FFFFIIIILLLLEEEESSSS
           The last component of all SCCS file pathnames must be of the
           form ssss...._f_i_l_e-_n_a_m_e.  New SCCS files are given mode 444 (see



      Page 5                                                   (9010-E)






      AAAADDDDMMMMIIIINNNN((((1111))))                    ((((UUUUNNNNIIIIXXXX 5555....0000))))                   AAAADDDDMMMMIIIINNNN((((1111))))



           _c_h_m_o_d(1)).  Write permission in the pertinent directory is,
           of course, required to create a file.  All writing done by
           _a_d_m_i_n is to a temporary x-file, called xxxx...._f_i_l_e-_n_a_m_e (see
           _g_e_t(1)), created with mode 444 if the _a_d_m_i_n command is
           creating a new SCCS file, or with the same mode as the SCCS
           file if it exists.  After successful execution of _a_d_m_i_n, 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
           _e_d(1).  _C_a_r_e _m_u_s_t _b_e _t_a_k_e_n! The edited file should _a_l_w_a_y_s be
           processed by an aaaaddddmmmmiiiinnnn ----hhhh to check for corruption followed by
           an aaaaddddmmmmiiiinnnn ----zzzz to generate a proper check-sum.  Another aaaaddddmmmmiiiinnnn
           ----hhhh is recommended to ensure the SCCS file is valid.

           _A_d_m_i_n also makes use of a transient lock file (called
           zzzz...._f_i_l_e-_n_a_m_e), which prevents simultaneous updates to the
           SCCS file by different users.  See _g_e_t(1) for further
           information.

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           delta(1), ed(1), get(1), help(1), prs(1), what(1),
           sccsfile(4).
           _S_o_u_r_c_e _C_o_d_e _C_o_n_t_r_o_l _S_y_s_t_e_m _U_s_e_r'_s _G_u_i_d_e in the _R_O_S _U_t_i_l_i_t_y
           _G_u_i_d_e

      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
           Use _h_e_l_p(1) for explanations.


















      Page 6                                                   (9010-E)



