get.html

IEEE 1003.1-2003, Single Unix Specification v3

</td>
<td align="left">
<p class="tent">No branch successor</p>
</td>
<td align="left">
<p class="tent">R.L.B.mS</p>
</td>
<td align="left">
<p class="tent">R.L.B.(mS+1)</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">R.L.B</p>
</td>
<td align="center">
<p class="tent">yes</p>
</td>
<td align="left">
<p class="tent">No branch successor</p>
</td>
<td align="left">
<p class="tent">R.L.B.mS</p>
</td>
<td align="left">
<p class="tent">R.L.(mB+1).1</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">R.L.B.S</p>
</td>
<td align="center">
<p class="tent">no</p>
</td>
<td align="left">
<p class="tent">No branch successor</p>
</td>
<td align="left">
<p class="tent">R.L.B.S</p>
</td>
<td align="left">
<p class="tent">R.L.B.(S+1)</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">R.L.B.S</p>
</td>
<td align="center">
<p class="tent">yes</p>
</td>
<td align="left">
<p class="tent">No branch successor</p>
</td>
<td align="left">
<p class="tent">R.L.B.S</p>
</td>
<td align="left">
<p class="tent">R.L.(mB+1).1</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">R.L.B.S</p>
</td>
<td align="center">
<p class="tent">-</p>
</td>
<td align="left">
<p class="tent">Branch successor</p>
</td>
<td align="left">
<p class="tent">R.L.B.S</p>
</td>
<td align="left">
<p class="tent">R.L.(mB+1).1</p>
</td>
</tr>
</table>
</center>

<dl compact>
<dt>*</dt>

<dd>R, L, B, and S are the release, level, branch, and sequence components of the SID, respectively; m means maximum. Thus, for
example, R.mL means &quot;the maximum level number within release R''; R.L.(mB+1).1 means &quot;the first sequence number on the new branch
(that is, maximum branch number plus one) of level L within release R&quot;. Note that if the SID specified is of the form R.L, R.L.B,
or R.L.B.S, each of the specified components shall exist.</dd>

<dt>**</dt>

<dd>hR is the highest existing release that is lower than the specified, nonexistent, release R.</dd>

<dt>***</dt>

<dd>This is used to force creation of the first delta in a new release.</dd>

<dt><img src="../images/dagger.gif" border="0"></dt>

<dd>The <b>-b</b> option is effective only if the <b>b</b> flag is present in the file. An entry of <tt>'-'</tt> means
&quot;irrelevant&quot;.</dd>

<dt><img src="../images/doubledagger.gif" border="0"></dt>

<dd>This case applies if the <b>d</b> (default SID) flag is not present in the file. If the <b>d</b> flag is present in the file,
then the SID obtained from the <b>d</b> flag is interpreted as if it had been specified on the command line. Thus, one of the other
cases in this table applies.</dd>
</dl>

<h5><a name="tag_04_60_13_01"></a>System Date and Time</h5>

<p>When a <b>g-file</b> is generated, the creation time of deltas in the SCCS file may be taken into account. If any of these times
are apparently in the future, the behavior is unspecified.</p>

<h5><a name="tag_04_60_13_02"></a>Identification Keywords</h5>

<p>Identifying information shall be inserted into the text retrieved from the SCCS file by replacing identification keywords with
their value wherever they occur. The following keywords may be used in the text stored in an SCCS file:</p>

<dl compact>
<dt>%<b>M</b>%</dt>

<dd>Module name: either the value of the <b>m</b> flag in the file, or if absent, the name of the SCCS file with the leading
<b>s.</b> removed.</dd>

<dt>%<b>I</b>%</dt>

<dd>SCCS identification (SID) (%<b>R</b>%.%<b>L</b>% or %<b>R</b>%.%<b>L</b>%.%<b>B</b>%.%<b>S</b>%) of the retrieved text.</dd>

<dt>%<b>R</b>%</dt>

<dd>Release.</dd>

<dt>%<b>L</b>%</dt>

<dd>Level.</dd>

<dt>%<b>B</b>%</dt>

<dd>Branch.</dd>

<dt>%<b>S</b>%</dt>

<dd>Sequence.</dd>

<dt>%<b>D</b>%</dt>

<dd>Current date (<i>YY</i>/<i>MM</i>/<i>DD</i>).</dd>

<dt>%<b>H</b>%</dt>

<dd>Current date (<i>MM</i>/<i>DD</i>/<i>YY</i>).</dd>

<dt>%<b>T</b>%</dt>

<dd>Current time (<i>HH</i>:<i>MM</i>:<i>SS</i>).</dd>

<dt>%<b>E</b>%</dt>

<dd>Date newest applied delta was created (<i>YY</i>/<i>MM</i>/<i>DD</i>).</dd>

<dt>%<b>G</b>%</dt>

<dd>Date newest applied delta was created (<i>MM</i>/<i>DD</i>/<i>YY</i>).</dd>

<dt>%<b>U</b>%</dt>

<dd>Time newest applied delta was created (<i>HH</i>:<i>MM</i>:<i>SS</i>).</dd>

<dt>%<b>Y</b>%</dt>

<dd>Module type: value of the <b>t</b> flag in the SCCS file.</dd>

<dt>%<b>F</b>%</dt>

<dd>SCCS filename.</dd>

<dt>%<b>P</b>%</dt>

<dd>SCCS absolute pathname.</dd>

<dt>%<b>Q</b>%</dt>

<dd>The value of the <b>q</b> flag in the file.</dd>

<dt>%<b>C</b>%</dt>

<dd>Current line number. This keyword is intended for identifying messages output by the program, such as &quot;this should not have
happened&quot; type errors. It is not intended to be used on every line to provide sequence numbers.</dd>

<dt>%<b>Z</b>%</dt>

<dd>The four-character string <tt>"@(#)"</tt> recognizable by <a href="../utilities/what.html"><i>what</i></a>.</dd>

<dt>%<b>W</b>%</dt>

<dd>A shorthand notation for constructing <a href="../utilities/what.html"><i>what</i></a> strings: 

<pre>
<tt>%W%=%Z%%M%&lt;tab&gt;%I%
</tt>
</pre>
</dd>

<dt>%<b>A</b>%</dt>

<dd>Another shorthand notation for constructing <a href="../utilities/what.html"><i>what</i></a> strings: 

<pre>
<tt>%A%=%Z%%Y%%M%%I%%Z%
</tt>
</pre>
</dd>
</dl>
</blockquote>

<h4><a name="tag_04_60_14"></a>EXIT STATUS</h4>

<blockquote>
<p>The following exit values shall be returned:</p>

<dl compact>
<dt>&nbsp;0</dt>

<dd>Successful completion.</dd>

<dt>&gt;0</dt>

<dd>An error occurred.</dd>
</dl>
</blockquote>

<h4><a name="tag_04_60_15"></a>CONSEQUENCES OF ERRORS</h4>

<blockquote>
<p>Default.</p>
</blockquote>

<hr>
<div class="box"><em>The following sections are informative.</em></div>

<h4><a name="tag_04_60_16"></a>APPLICATION USAGE</h4>

<blockquote>
<p>Problems can arise if the system date and time have been modified (for example, put forward and then back again, or
unsynchronized clocks across a network) and can also arise when different values of the <i>TZ</i> environment variable are
used.</p>

<p>Problems of a similar nature can also arise for the operation of the <a href="../utilities/delta.html"><i>delta</i></a> utility,
which compares the previous file body against the working file as part of its normal operation.</p>
</blockquote>

<h4><a name="tag_04_60_17"></a>EXAMPLES</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_60_18"></a>RATIONALE</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_60_19"></a>FUTURE DIRECTIONS</h4>

<blockquote>
<p>The <b>-lp</b> option may be withdrawn in a future version.</p>
</blockquote>

<h4><a name="tag_04_60_20"></a>SEE ALSO</h4>

<blockquote>
<p><a href="admin.html"><i>admin</i></a> , <a href="delta.html"><i>delta</i></a> , <a href="prs.html"><i>prs</i></a> , <a href=
"what.html"><i>what</i></a></p>
</blockquote>

<h4><a name="tag_04_60_21"></a>CHANGE HISTORY</h4>

<blockquote>
<p>First released in Issue 2.</p>
</blockquote>

<h4><a name="tag_04_60_22"></a>Issue 5</h4>

<blockquote>
<p>A correction is made to the first format string in STDOUT.</p>

<p>The interpretation of the <i>YY</i> component of the <b>-c</b> <i>cutoff</i> argument is noted.</p>
</blockquote>

<h4><a name="tag_04_60_23"></a>Issue 6</h4>

<blockquote>
<p>The obsolescent SYNOPSIS is removed, removing the <b>-lp</b> option.</p>

<p>The normative text is reworded to avoid use of the term &quot;must&quot; for application requirements.</p>

<p>The Open Group Corrigendum U025/5 is applied, correcting text in the OPTIONS section.</p>

<p>The Open Group Corrigendum U048/1 is applied.</p>

<p>The Open Group Interpretation PIN4C.00014 is applied.</p>

<p>The Open Group Base Resolution bwg2001-007 is applied as follows:</p>

<ul>
<li>
<p>The EXTENDED DESCRIPTION section is updated to make partial SID handling unspecified, reflecting common usage, and to clarify
SID ranges.</p>
</li>

<li>
<p>New text is added to the EXTENDED DESCRIPTION and APPLICATION USAGE sections regarding how the system date and time may be taken
into account.</p>
</li>

<li>
<p>The <i>TZ</i> environment variable is added to the ENVIRONMENT VARIABLES section.</p>
</li>
</ul>
</blockquote>

<div class="box"><em>End of informative text.</em></div>

<hr>
<hr size="2" noshade>
<center><font size="2"><!--footer start-->
UNIX &reg; is a registered Trademark of The Open Group.<br>
POSIX &reg; is a registered Trademark of The IEEE.<br>
[ <a href="../mindex.html">Main Index</a> | <a href="../basedefs/contents.html">XBD</a> | <a href=
"../utilities/contents.html">XCU</a> | <a href="../functions/contents.html">XSH</a> | <a href="../xrat/contents.html">XRAT</a>
]</font></center>

<!--footer end-->
<hr size="2" noshade>
</body>
</html>