📄 admin.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta name="generator" content="HTML Tidy, see www.w3.org"><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><link type="text/css" rel="stylesheet" href="style.css"><!-- Generated by The Open Group's rhtm tool v1.2.1 --><!-- Copyright (c) 2001-2003 The Open Group, All Rights Reserved --><title>admin</title></head><body bgcolor="white"><script type="text/javascript" language="JavaScript" src="../jscript/codes.js"></script><basefont size="3"> <a name="admin"></a> <a name="tag_04_01"></a><!-- admin --> <!--header start--><center><font size="2">The Open Group Base Specifications Issue 6<br>IEEE Std 1003.1, 2003 Edition<br>Copyright © 2001-2003 The IEEE and The Open Group, All Rights reserved.</font></center><!--header end--><hr size="2" noshade><h4><a name="tag_04_01_01"></a>NAME</h4><blockquote>admin - create and administer SCCS files (<b>DEVELOPMENT</b>)</blockquote><h4><a name="tag_04_01_02"></a>SYNOPSIS</h4><blockquote class="synopsis"><div class="box"><code><tt><sup>[<a href="javascript:open_code('XSI')">XSI</a>]</sup> <img src="../images/opt-start.gif" alt="[Option Start]" border="0"> admin -i</tt><b>[</b><i>name</i><b>][</b><tt>-n</tt><b>][</b><tt>-a</tt><i>login</i><b>][</b><tt>-d</tt> <i>flag</i><b>][</b><tt>-e</tt> <i>login</i><b>][</b><tt>-f</tt> <i>flag</i><b>][</b><tt>-m</tt><i>mrlist</i><b>]<br></b> <tt> </tt> <b>[</b><tt>-r</tt><i>rel</i><b>][</b><tt>-t</tt><b>[</b><i>name</i><b>][</b><tt>-y</tt><b>[</b><i>comment</i><b>]]</b> <i>newfile</i><tt><br><br>admin -n</tt><b>[</b><tt>-a</tt> <i>login</i><b>][</b><tt>-d</tt> <i>flag</i><b>][</b><tt>-e</tt> <i>login</i><b>][</b><tt>-f</tt><i>flag</i><b>][</b><tt>-m</tt> <i>mrlist</i><b>][</b><tt>-t</tt><b>[</b><i>name</i><b>]]</b><tt><br> </tt> <b>[</b><tt>-y</tt><b>[</b><i>comment</i><b>]]</b> <i>newfile</i> <tt>...<br><br> admin</tt> <b>[</b><tt>-a</tt> <i>login</i><b>][</b><tt>-d</tt> <i>flag</i><b>][</b><tt>-m</tt> <i>mrlist</i><b>][</b><tt>-r</tt><i>rel</i><b>][</b><tt>-t</tt><b>[</b><i>name</i><b>]]</b> <tt></tt><i>file</i> <tt>...<br><br> admin -h</tt> <i>file</i> <tt>...<br><br> admin -z</tt> <i>file</i> <tt>... <img src="../images/opt-end.gif" alt="[Option End]" border="0"></tt></code></div><tt><br></tt></blockquote><h4><a name="tag_04_01_03"></a>DESCRIPTION</h4><blockquote><p>The <i>admin</i> utility shall create new SCCS files or change parameters of existing ones. If a named file does not exist, itshall be created, and its parameters shall be initialized according to the specified options. Parameters not initialized by anoption shall be assigned a default value. If a named file does exist, parameters corresponding to specified options shall bechanged, and other parameters shall be left as is.</p><p>All SCCS filenames supplied by the application shall be of the form s.<i>filename</i>. New SCCS files shall be given read-onlypermission mode. Write permission in the parent directory is required to create a file. All writing done by <i>admin</i> shall beto a temporary <i>x-file</i>, named x.<i>filename</i> (see <a href="get.html"><i>get</i></a> ) created with read-only mode if<i>admin</i> is creating a new SCCS file, or created with the same mode as that of the SCCS file if the file already exists. Aftersuccessful execution of <i>admin</i>, the SCCS file shall be removed (if it exists), and the <i>x-file</i> shall be renamed withthe name of the SCCS file. This ensures that changes are made to the SCCS file only if no errors occur.</p><p>The <i>admin</i> utility shall also use a transient lock file (named z.<i>filename</i>), which is used to prevent simultaneousupdates to the SCCS file; see <a href="get.html"><i>get</i></a> .</p></blockquote><h4><a name="tag_04_01_04"></a>OPTIONS</h4><blockquote><p>The <i>admin</i> utility shall conform to the Base Definitions volume of IEEE Std 1003.1-2001, <a href="../basedefs/xbd_chap12.html#tag_12_02">Section 12.2, Utility Syntax Guidelines</a>, except that the <b>-i</b>, <b>-t</b>, and<b>-y</b> options have optional option-arguments. These optional option-arguments shall not be presented as separate arguments. Thefollowing options are supported:</p><dl compact><dt><b>-n</b></dt><dd>Create a new SCCS file. When <b>-n</b> is used without <b>-i</b>, the SCCS file shall be created with control information butwithout any file data.</dd><dt><b>-i[</b><i>name</i><b>]</b></dt><dd>Specify the <i>name</i> of a file from which the text for a new SCCS file shall be taken. The text constitutes the first deltaof the file (see the <b>-r</b> option for the delta numbering scheme). If the <b>-i</b> option is used, but the <i>name</i>option-argument is omitted, the text shall be obtained by reading the standard input. If this option is omitted, the SCCS fileshall be created with control information but without any file data. The <b>-i</b> option implies the <b>-n</b> option.</dd><dt><b>-r </b> <i>SID</i></dt><dd>Specify the SID of the initial delta to be inserted. This SID shall be a trunk SID; that is, the branch and sequence numbersshall be zero or missing. The level number is optional, and defaults to 1.</dd><dt><b>-t[</b><i>name</i><b>]</b></dt><dd>Specify the <i>name</i> of a file from which descriptive text for the SCCS file shall be taken. In the case of existing SCCSfiles (neither <b>-i</b> nor <b>-n</b> is specified): <ul><li><p>A <b>-t</b> option without a <i>name</i> option-argument shall cause the removal of descriptive text (if any) currently in theSCCS file.</p></li><li><p>A <b>-t</b> option with a <i>name</i> option-argument shall cause the text (if any) in the named file to replace the descriptivetext (if any) currently in the SCCS file.</p></li></ul></dd><dt><b>-f </b> <i>flag</i></dt><dd>Specify a <i>flag</i>, and, possibly, a value for the <i>flag</i>, to be placed in the SCCS file. Several <b>-f</b> options maybe supplied on a single <i>admin</i> command line. Implementations shall recognize the following flags and associated values: <dl compact><dt><b>b</b></dt><dd>Allow use of the <b>-b</b> option on a <a href="../utilities/get.html"><i>get</i></a> command to create branch deltas.</dd><dt><b>c</b><i>ceil</i></dt><dd>Specify the highest release (that is, ceiling), a number less than or equal to 9999, which may be retrieved by a <a href="../utilities/get.html"><i>get</i></a> command for editing. The default value for an unspecified <b>c</b> flag shall be 9999.</dd><dt><b>f</b><i>floor</i></dt><dd>Specify the lowest release (that is, floor), a number greater than 0 but less than 9999, which may be retrieved by a <a href="../utilities/get.html"><i>get</i></a> command for editing. The default value for an unspecified <b>f</b> flag shall be 1.</dd><dt><b>d</b><i>SID</i></dt><dd>Specify the default delta number (SID) to be used by a <a href="../utilities/get.html"><i>get</i></a> command.</dd><dt><b>i</b><i>str</i></dt><dd>Treat the "No ID keywords" message issued by <a href="../utilities/get.html"><i>get</i></a> or <a href="../utilities/delta.html"><i>delta</i></a> as a fatal error. In the absence of this flag, the message is only a warning. Themessage is issued if no SCCS identification keywords (see <a href="get.html"><i>get</i></a> ) are found in the text retrieved orstored 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>s.</dd><dt><b>j</b></dt><dd>Allow concurrent <a href="../utilities/get.html"><i>get</i></a> commands for editing on the same SID of an SCCS file. Thisallows multiple concurrent updates to the same version of the SCCS file.</dd><dt><b>l</b><i>list</i></dt><dd>Specify a <i>list</i> of releases to which deltas can no longer be made (that is, <a href="../utilities/get.html"><i>get</i></a> <b>-e</b> against one of these locked releases fails). Conforming applications shall use thefollowing syntax to specify a <i>list</i>. Implementations may accept additional forms as an extension: <pre><tt><list> ::= a | <range-list><range-list> ::= <range> | <range-list>, <range><range> ::= <SID></tt></pre><p>The character <i>a</i> in the <i>list</i> shall be equivalent to specifying all releases for the named SCCS file. Thenon-terminal <<i>SID</i>> in range shall be the delta number of an existing delta associated with the SCCS file.</p></dd><dt><b>n</b></dt><dd>Cause <a href="../utilities/delta.html"><i>delta</i></a> to create a null delta in each of those releases (if any) beingskipped 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 shallcause 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 <b>n</b> flag may be ignored; that is, if the <b>-r</b> option is used to set therelease number of the initial SID to a value greater than 1, null deltas need not be created for the "skipped" releases.</dd><dt><b>q</b><i>text</i></dt><dd>Substitute user-definable <i>text</i> for all occurrences of the %<b>Q</b>% keyword in the SCCS file text retrieved by <a href="../utilities/get.html"><i>get</i></a>.</dd><dt><b>m</b><i>mod</i></dt><dd>Specify the module name of the SCCS file substituted for all occurrences of the %<b>M</b>% keyword in the SCCS file textretrieved by <a href="../utilities/get.html"><i>get</i></a>. If the <b>m</b> flag is not specified, the value assigned shall be thename of the SCCS file with the leading <tt>'.'</tt> removed.</dd><dt><b>t</b><i>type</i></dt><dd>Specify the <i>type</i> of module in the SCCS file substituted for all occurrences of the %<b>Y</b>% keyword in the SCCS filetext retrieved by <a href="../utilities/get.html"><i>get</i></a>.</dd><dt><b>v</b><i>pgm</i></dt><dd>Cause <a href="../utilities/delta.html"><i>delta</i></a> to prompt for modification request (MR) numbers as the reason forcreating a delta. The optional value specifies the name of an MR number validation program. (If this flag is set when creating anSCCS file, the application shall ensure that the <b>m</b> option is also used even if its value is null.)</dd></dl></dd><dt><b>-d </b> <i>flag</i></dt><dd>Remove (delete) the specified <i>flag</i> from an SCCS file. Several <b>-d</b> options may be supplied on a single <i>admin</i>command. See the <b>-f</b> option for allowable <i>flag</i> names. (The <b>l</b> <i>list</i> flag gives a <i>list</i> of releasesto be unlocked. See the <b>-f</b> option for further description of the <b>l</b> flag and the syntax of a <i>list</i>.)</dd><dt><b>-a </b> <i>login</i></dt><dd>Specify a <i>login</i> name, or numerical group ID, to be added to the list of users who may make deltas (changes) to the SCCSfile. A group ID shall be equivalent to specifying all <i>login</i> names common to that group ID. Several <b>-a</b> options may beused on a single <i>admin</i> command line. As many <i>login</i>s, or numerical group IDs, as desired may be on the listsimultaneously. If the list of users is empty, then anyone may add deltas. If <i>login</i> or group ID is preceded by a<tt>'!'</tt> , the users so specified shall be denied permission to make deltas.</dd><dt><b>-e </b> <i>login</i></dt><dd>Specify a <i>login</i> name, or numerical group ID, to be erased from the list of users allowed to make deltas (changes) to theSCCS file. Specifying a group ID is equivalent to specifying all <i>login</i> names common to that group ID. Several <b>-e</b>options may be used on a single <i>admin</i> command line.</dd><dt><b>-y[</b><i>comment</i><b>]</b></dt><dd>Insert the <i>comment</i> text into the SCCS file as a comment for the initial delta in a manner identical to that of <a href="../utilities/delta.html"><i>delta</i></a>. In the POSIX locale, omission of the <b>-y</b> option shall result in a default commentline being inserted in the form: <pre><tt>"date and time created %s %s by %s", <</tt><i>date</i><tt>>, <</tt><i>time</i><tt>>, <</tt><i>login</i><tt>>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -