admin.html

unix 下的C开发手册,还用详细的例程。

(If this flag is set when creating an SCCS file, the
<b>m</b>
option must also be used even if its value is null.)

</dl>
<br>
<dt><b>-d&nbsp;</b><i>flag</i>
<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
flag gives a
<i>list</i>
of releases to 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>.)
<br>
<dt><b>-a&nbsp;</b><i>login</i>
<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 SCCS file.
A group ID is equivalent to specifying all
<i>login</i>
names common to that group ID.
Several
<b>-a</b>
options may be used on a single
<i>admin</i>
command line.
As many
<i>login</i>s,
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
<i>login</i>
or group ID
is preceded by a !,
the users so specified are denied permission to make deltas.
<br>
<dt><b>-e&nbsp;</b><i>login</i>
<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 the SCCS 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.
<br>
<p>
<dt><b>-y[</b><i>comment</i><b>]</b><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
<i><a href="delta.html">delta</a></i>.
In the POSIX locale, omission of the
<b>-y</b>
option results in a default
comment line being inserted in the form:
<code>
<p>
<tt>"date and time created %s %s by %s"</tt>, &lt;<i>date</i>&gt;,
&lt;<i>time</i>&gt;,
&lt;<i>login</i>&gt;
</code>
where
&lt;<i>date</i>&gt;
is expressed in the
<i><a href="date.html">date</a></i>
utility's %y/%m/%d format,
&lt;<i>time</i>&gt;
in the
<i><a href="date.html">date</a></i>
utility's %T format and
&lt;<i>login</i>&gt;
is the login name of the user creating the file.
<br>
<br>
<dt><b>-m&nbsp;</b><i>mrlist</i>
<dd>
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
<i><a href="delta.html">delta</a></i>.
The
<b>v</b>
flag must be set and the MR numbers are validated if the
<b>v</b>
flag has a value (the name of an MR number validation program).
Diagnostics will occur if the
<b>v</b>
flag is not set or MR validation fails.
<br>
<br>
<dt><b>-h</b>
<dd>Check the structure of the SCCS file
and compare the newly
computed checksum (the sum of all the characters in the SCCS file
except those in the first line) with the checksum that is stored
in the first line of the SCCS file.
Appropriate error diagnostics are produced.
<br>
<dt><b>-z</b>
<dd>Recompute the
SCCS file checksum and store it in the first line
of the SCCS file (see
<b>-h</b>
above).
Note that use of this option on a truly corrupted file
may prevent future detection of the corruption.
<p>
</dl>
<br>
</blockquote><h4><a name = "tag_000_000_005">&nbsp;</a>OPERANDS</h4><blockquote>
The following operands are supported:
<dl compact>

<dt><i>file</i><dd>A pathname of an existing SCCS file or a directory.
If
<i>file</i>
is a directory,
<i>admin</i>
behaves as though each file in the directory were
specified as a named file,
except that non-SCCS files
(last component of the pathname does not begin with
s.)
and unreadable files are silently ignored.

<dt><i>newfile</i><dd>A pathname of an SCCS file to be created.

</dl>
<p>
If a single instance
<i>file</i>
or
<i>newfile</i>
is specified as
-,
the standard input is read;
each line of the standard input is taken to be the name of an SCCS file
to be processed.
Non-SCCS files and unreadable files are silently ignored.
</blockquote><h4><a name = "tag_000_000_006">&nbsp;</a>STDIN</h4><blockquote>
The standard input is a text file used only if the
<b>-i</b>
is specified without an option-argument or if a
<i>file</i>
or
<i>newfile</i>
operand is specified as -.
If the first character of any standard input line
is SOH (binary 001), the results are unspecified.
</blockquote><h4><a name = "tag_000_000_007">&nbsp;</a>INPUT FILES</h4><blockquote>
The existing SCCS files are text files of an unspecified format.
The file named by the
<b>-i</b>
option's
<i>name</i>
option-argument is a text file;
if the first character of any line in this file
is SOH (binary 001), the results are unspecified.
</blockquote><h4><a name = "tag_000_000_008">&nbsp;</a>ENVIRONMENT VARIABLES</h4><blockquote>
The following environment variables affect the execution of
<i>admin</i>:
<dl compact>

<dt><i>LANG</i><dd>Provide a default value for the internationalisation variables
that are unset or null.
If
<i>LANG</i>
is unset or null, the corresponding value from the
implementation-dependent default locale will be used.
If any of the internationalisation variables contains an invalid setting, the
utility will behave as if none of the variables had been defined.

<dt><i>LC_ALL</i><dd>
If set to a non-empty string value,
override the values of all the other internationalisation variables.

<dt><i>LC_CTYPE</i><dd>
Determine the
locale for the interpretation of sequences of bytes of text data as
characters (for example, single- as opposed to multi-byte characters
in arguments and input files).

<dt><i>LC_MESSAGES</i><dd>
Determine the locale that should be used to affect
the format and contents of diagnostic
messages written to standard error and the contents of the default
<b>-y</b>
comment.

<dt><i>NLSPATH</i><dd>
Determine the location of message catalogues
for the processing of
<i>LC_MESSAGES .
</i>
</dl>
</blockquote><h4><a name = "tag_000_000_009">&nbsp;</a>ASYNCHRONOUS EVENTS</h4><blockquote>
Default.
</blockquote><h4><a name = "tag_000_000_010">&nbsp;</a>STDOUT</h4><blockquote>
Not used.
</blockquote><h4><a name = "tag_000_000_011">&nbsp;</a>STDERR</h4><blockquote>
Used only for diagnostic messages.
<br>
</blockquote><h4><a name = "tag_000_000_012">&nbsp;</a>OUTPUT FILES</h4><blockquote>
Any SCCS files created are text files of an unspecified format.
During processing of a
<i>file</i>,
a locking
<i>z-file</i>,
as described in
<i><a href="get.html">get</a></i>,
may be created and deleted.
<br>
</blockquote><h4><a name = "tag_000_000_013">&nbsp;</a>EXTENDED DESCRIPTION</h4><blockquote>
None.
</blockquote><h4><a name = "tag_000_000_014">&nbsp;</a>EXIT STATUS</h4><blockquote>
The following exit values are returned:
<dl compact>

<dt>0<dd>Successful completion.

<dt>&gt;0<dd>An error occurred.

</dl>
</blockquote><h4><a name = "tag_000_000_015">&nbsp;</a>CONSEQUENCES OF ERRORS</h4><blockquote>
Default.
</blockquote><h4><a name = "tag_000_000_016">&nbsp;</a>APPLICATION USAGE</h4><blockquote>
It is recommended that directories containing SCCS files be
writable by the owner only,
and that SCCS files themselves be read-only.
The mode of the directories
should allow
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.
</blockquote><h4><a name = "tag_000_000_017">&nbsp;</a>EXAMPLES</h4><blockquote>
None.
</blockquote><h4><a name = "tag_000_000_018">&nbsp;</a>FUTURE DIRECTIONS</h4><blockquote>
A version of
<i>admin</i>
that fully supports the <b>XBD</b> specification, <a href="../xbd/utilconv.html#usg"><b>Utility Syntax Guidelines</b>&nbsp;</a>  may be
introduced in a future issue.
</blockquote><h4><a name = "tag_000_000_019">&nbsp;</a>SEE ALSO</h4><blockquote>
<i><a href="delta.html">delta</a></i>,
<i><a href="get.html">get</a></i>,
<i><a href="prs.html">prs</a></i>,
<i><a href="what.html">what</a></i>.
</blockquote><hr size=2 noshade>
<center><font size=2>
UNIX &reg; is a registered Trademark of The Open Group.<br>
Copyright &copy; 1997 The Open Group
<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]

</font></center><hr size=2 noshade>
</body></html>