📄 admin.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>admin</title></head><body bgcolor=white><center><font size=2>The Single UNIX ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_000_000_001"> </a>NAME</h4><blockquote>admin - create and administer SCCS files (<b>DEVELOPMENT</b>)</blockquote><h4><a name = "tag_000_000_002"> </a>SYNOPSIS</h4><blockquote><pre><code>admin -i<b>[</b><i>name</i><b>][</b>-n<b>][</b>-a <i>login</i><b>][</b>-d <i>flag</i><b>][</b>-f <i>flag</i><b>][</b>-m <i>mrlist</i><b>][</b>-r <i>rel</i><b>][</b>-t<b>[</b><i>name</i><b>][</b>-y<b>[</b><i>comment</i><b>]] </b><i>newfile</i>admin <i>-n</i><b>[</b>-a <i>login</i><b>][</b>-d <i>flag</i><b>][</b>-f <i>flag</i><b>][</b>-m <i>mrlist</i><b>][</b>-t<b>[</b><i>name</i><b>]][</b>-y<b>[</b><i>comment</i><b>]]</b><i>newfile</i> ... admin <b>[</b>-a <i>login</i><b>][</b>-d <i>flag</i><b>][</b>-m <i>mrlist</i><b>][</b>-r <i>rel</i><b>][</b>-t<b>[</b><i>name</i><b>]]</b><i>file</i> ... admin -h <i>file</i> ... admin -z <i>file</i> ... </code></pre></blockquote><h4><a name = "tag_000_000_003"> </a>DESCRIPTION</h4><blockquote>The<i>admin</i>utilityis used to create new SCCS filesand change parameters of existing ones.If a named file does not exist, it is created,and its parameters are initialised according to the specified options.Parameters not initialised by an optionare assigned a default value.If a named file does exist,parameters corresponding to specified options are changed,and other parameters are left as is.<p>All SCCS filenames must be of the forms.<i>filename</i>.New SCCS filenames aregiven read-only permission mode.Write permission in the parent directory is required to create a file.All writing done by<i>admin</i>is to a temporary<i>x-file ,</i>namedx.<i>filename</i>(see<i>get )</i>created with read-only mode if<i>admin</i>is creating a new SCCS file, or created with the same mode as thatof the SCCS file if the file already exists.After successful execution of<i>admin,</i>the SCCS file is removed (if it exists), and the<i>x-file</i>is renamedwith the name of the SCCS file.This ensures that changes are made to the SCCS file only if noerrors occur.<p>The<i>admin</i>utility also uses a transient lock file (namedz.<i>filename</i>)which is used toprevent simultaneous updates to the SCCS file.See<i><a href="get.html">get</a></i>for further information.</blockquote><h4><a name = "tag_000_000_004"> </a>OPTIONS</h4><blockquote>The<i>admin</i>utility supports the <b>XBD</b> specification, <a href="../xbd/utilconv.html#usg"><b>Utility Syntax Guidelines</b> </a> ,except that the <b>-i</b>, <b>-t</b> and <b>-y</b>options have optional option-arguments.These optional option-arguments cannot be presented as separate arguments.The following options are supported:<dl compact><dt><b>-n</b><dd>Create a new SCCS file.When<b>-n</b>is used without<b>-i</b>,the SCCS file is createdwith control information but without any file data.<dt><b>-i[</b><i>name</i><b>]</b><dd>Specify the<i>name</i>of a file from whichthe text for a new SCCS file is to be taken.The text constitutes the first delta of the file(see<b>-r</b>option for delta numbering scheme).If the<b>-i</b>option is used, but the<i>name</i>option-argument is omitted,the text is obtained by reading the standard input.If this option is omitted,the SCCS file is createdwith control information but without any file data.The<b>-i</b>option implies the<b>-n</b>option.<dt><b>-r </b><i>rel</i><dd>Specify the<i>rel</i>easeinto which the initial delta is inserted.If the<b>-r</b>option 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).<dt><b>-t[</b><i>name</i><b>]</b><dd>Specify the<i>name</i>of a file from which descriptive text for the SCCS file is to be taken.In the case of existing SCCS files(neither<b>-i</b>nor<b>-n</b>is specified):<ul><li>A<b>-t</b>option without a<i>name</i>option-argument causes the removal of descriptive text(if any) currently in the SCCS file.<li>A<b>-t</b>option with a<i>name</i>option-argument causes the text (if any) in thenamed file to replacethe descriptive text (if any) currently in the SCCS file.</ul><dt><b>-f </b><i>flag</i><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 may be supplied on a single<i>admin</i>command line.The allowable flags and their values are:<dl compact><dt><b>b</b><dd>Allow use of the<b>-b</b>option on a<i><a href="get.html">get</a></i>command to create branch deltas.<dt><b>c</b><i>ceil</i><dd>Specify the highest release (that is, ceiling),a number less than or equal to 9999, which may beretrieved by a<i><a href="get.html">get</a></i>command for editing.The default value for an unspecified<b>c</b>flag is 9999.<dt><b>f</b><i>floor</i><dd>Specify the lowest release (that is, floor),a number greater than 0 but less than 9999,which may be retrieved by a<i><a href="get.html">get</a></i>command for editing.The default value for an unspecified<b>f</b>flag is 1.<dt><b>d</b><i>SID</i><dd>Specify the default delta number (SID) to be used by a<i><a href="get.html">get</a></i>command.<dt><b>i</b><i>str</i><dd>Treat the "No id keywords" message issued by<i><a href="get.html">get</a></i>or<i><a href="delta.html">delta</a></i>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<i><a href="get.html">get</a></i>)are foundin the text retrieved or stored in the SCCS file.If a value is supplied, the keywords must exactlymatch the given string; however, the string must containa keyword, and no embedded newlines.<dt><b>j</b><dd>Allow concurrent<i><a href="get.html">get</a></i>commands for editing on the same SID of an SCCS file.This allows multiple concurrent updates to the sameversion of the SCCS file.<dt><b>l</b><i>list</i><dd>Specify a<i>list</i>of releases to which deltas can no longer be made (that is,<i><a href="get.html">get</a></i><b>-e</b>against one of these locked releases fails).The<i>list</i>has the following syntax:<pre><code><list> ::= <range> | <list>, <range><range> ::= SID | a</code></pre>The characterain the<i>list</i>is equivalent to specifying all releases for the named SCCS file.<dt><b>n</b><dd>Cause<i><a href="delta.html">delta</a></i>to create a null deltain each of those releases (if any) being skipped when a delta is madein a newrelease (for example, in making delta 5.1 after delta 2.7, releases 3 and 4are skipped).These null deltas serve as anchor points so that branch deltasmay later be created from them.The absence of this flag causes skipped releases to benon-existent in the SCCS file,preventing branch deltas from being created from them in the future.<dt><b>q</b><i>text</i><dd>Substitute user-definable<i>text</i>for all occurrencesof the <b>%Q%</b> keyword in the SCCS file text retrieved by<i><a href="get.html">get</a></i>.<dt><b>m</b><i>mod</i><dd>Specify the module name of the SCCS file substituted for alloccurrences of the <b>%M%</b> keyword in the SCCS filetext retrieved by<i><a href="get.html">get</a></i>.If the<b>m</b>flag is not specified, the valueassigned is the name of the SCCS file with the leading <b>s.</b> removed.<dt><b>t</b><i>type</i><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 file text retrieved by<i><a href="get.html">get</a></i>.<dt><b>v</b><i>pgm</i><dd>Cause<i><a href="delta.html">delta</a></i>to prompt for modification request (MR) numbers as thereason for creating a delta.The optional value specifies the name of an MR number validationprogram.⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -