get.html

IEEE 1003.1-2003, Single Unix Specification v3

Only the real user need have write permission in the current directory.</p>

<p>Lines in the <b>l-file</b> shall have the following format:</p>

<pre>
<tt>"%c%c%c<img src="../images/delta.gif" border="0">%s\t%s<img src="../images/delta.gif" border=
"0">%s\n", &lt;</tt><i>code1</i><tt>&gt;, &lt;</tt><i>code2</i><tt>&gt;, &lt;</tt><i>code3</i><tt>&gt;,
    &lt;</tt><i>SID</i><tt>&gt;, &lt;</tt><i>date-time</i><tt>&gt;, &lt;</tt><i>login</i><tt>&gt;
</tt>
</pre>

<p>where the entries are:</p>

<dl compact>
<dt>&lt;<i>code1</i>&gt;</dt>

<dd>A &lt;space&gt; if the delta was applied; <tt>'*'</tt> otherwise.</dd>

<dt>&lt;<i>code2</i>&gt;</dt>

<dd>A &lt;space&gt; if the delta was applied or was not applied and ignored; <tt>'*'</tt> if the delta was not applied and was not
ignored.</dd>

<dt>&lt;<i>code3</i>&gt;</dt>

<dd>A character indicating a special reason why the delta was or was not applied: 

<dl compact>
<dt><b>I</b></dt>

<dd>Included.</dd>

<dt><b>X</b></dt>

<dd>Excluded.</dd>

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

<dd>Cut off (by a <b>-c</b> option).</dd>
</dl>
</dd>

<dt>&lt;<i>date-time</i>&gt;</dt>

<dd>Date and time (using the format of the <a href="../utilities/date.html"><i>date</i></a> utility's <tt>%y</tt> / <tt>%m</tt> /
<tt>%d</tt> <tt>%T</tt> conversion specification format) of creation.</dd>

<dt>&lt;<i>login</i>&gt;</dt>

<dd>Login name of person who created <a href="../utilities/delta.html"><i>delta</i></a>.</dd>
</dl>

<p>The comments and MR data shall follow on subsequent lines, indented one &lt;tab&gt;. A blank line shall terminate each
entry.</p>

<p>The <b>p-file</b> shall be used to pass information resulting from a <i>get</i> with a <b>-e</b> option along to <a href=
"../utilities/delta.html"><i>delta</i></a>. Its contents shall also be used to prevent a subsequent execution of <i>get</i> with a
<b>-e</b> option for the same SID until <a href="../utilities/delta.html"><i>delta</i></a> is executed or the joint edit flag,
<b>j</b>, is set in the SCCS file. The <b>p-file</b> shall be created in the directory containing the SCCS file and the application
shall ensure that the effective user has write permission in that directory. It shall be writable by owner only, and owned by the
effective user. Each line in the <b>p-file</b> shall have the following format:</p>

<pre>
<tt>"%s<img src="../images/delta.gif" border="0">%s<img src="../images/delta.gif" border="0">%s<img src="../images/delta.gif"
border="0">%s%s%s\n", &lt;</tt><i>g-file SID</i><tt>&gt;,
    &lt;</tt><i>SID of new delta</i><tt>&gt;, &lt;</tt><i>login-name of real user</i><tt>&gt;,
    &lt;</tt><i>date-time</i><tt>&gt;, &lt;</tt><i>i-value</i><tt>&gt;, &lt;</tt><i>x-value</i><tt>&gt;
</tt>
</pre>

<p>where &lt;<i>i-value</i>&gt; uses the format <tt>""</tt> if no <b>-i</b> option was specified, and shall use the format:</p>

<pre>
<tt>"<img src="../images/delta.gif" border="0">-i%s", &lt;-i option</tt> <i>option-argument</i><tt>&gt;
</tt>
</pre>

<p>if a <b>-i</b> option was specified and &lt;<i>x-value</i>&gt; uses the format <tt>""</tt> if no <b>-x</b> option was specified,
and shall use the format:</p>

<pre>
<tt>"<img src="../images/delta.gif" border="0">-x%s", &lt;-x option</tt> <i>option-argument</i><tt>&gt;
</tt>
</pre>

<p>if a <b>-x</b> option was specified. There can be an arbitrary number of lines in the <b>p-file</b> at any time; no two lines
shall have the same new delta SID.</p>

<p>The <b>z-file</b> shall serve as a lock-out mechanism against simultaneous updates. Its contents shall be the binary process ID
of the command (that is, <i>get</i>) that created it. The <b>z-file</b> shall be created in the directory containing the SCCS file
for the duration of <i>get</i>. The same protection restrictions as those for the <b>p-file</b> shall apply for the <b>z-file</b>.
The <b>z-file</b> shall be created read-only.<br>
</p>
</blockquote>

<h4><a name="tag_04_60_13"></a>EXTENDED DESCRIPTION</h4>

<blockquote>
<center>
<table border="1" cellpadding="3" align="center">
<tr valign="top">
<th colspan="5" align="center">
<p class="tent"><b>Determination of SCCS Identification String</b></p>
</th>
</tr>

<tr valign="top">
<th align="center">
<p class="tent"><b>SID*</b></p>
</th>
<th align="center">
<p class="tent"><b>-b Keyletter</b></p>
</th>
<th align="center">
<p class="tent"><b>Other</b></p>
</th>
<th align="center">
<p class="tent"><b>SID</b></p>
</th>
<th align="center">
<p class="tent"><b>SID of Delta</b></p>
</th>
</tr>

<tr valign="top">
<th align="center">
<p class="tent"><b>Specified</b></p>
</th>
<th align="center">
<p class="tent"><b>Used<img src="../images/dagger.gif" border="0"></b></p>
</th>
<th align="center">
<p class="tent"><b>Conditions</b></p>
</th>
<th align="center">
<p class="tent"><b>Retrieved</b></p>
</th>
<th align="center">
<p class="tent"><b>to be Created</b></p>
</th>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">none<img src="../images/doubledagger.gif" border="0"></p>
</td>
<td align="center">
<p class="tent">no</p>
</td>
<td align="left">
<p class="tent">R defaults to mR</p>
</td>
<td align="left">
<p class="tent">mR.mL</p>
</td>
<td align="left">
<p class="tent">mR.(mL+1)</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">none<img src="../images/doubledagger.gif" border="0"></p>
</td>
<td align="center">
<p class="tent">yes</p>
</td>
<td align="left">
<p class="tent">R defaults to mR</p>
</td>
<td align="left">
<p class="tent">mR.mL</p>
</td>
<td align="left">
<p class="tent">mR.mL.(mB+1).1</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">no</p>
</td>
<td align="left">
<p class="tent">R &gt; mR</p>
</td>
<td align="left">
<p class="tent">mR.mL</p>
</td>
<td align="left">
<p class="tent">R.1***</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">no</p>
</td>
<td align="left">
<p class="tent">R = mR</p>
</td>
<td align="left">
<p class="tent">mR.mL</p>
</td>
<td align="left">
<p class="tent">mR.(mL+1)</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">yes</p>
</td>
<td align="left">
<p class="tent">R &gt; mR</p>
</td>
<td align="left">
<p class="tent">mR.mL</p>
</td>
<td align="left">
<p class="tent">mR.mL.(mB+1).1</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">yes</p>
</td>
<td align="left">
<p class="tent">R = mR</p>
</td>
<td align="left">
<p class="tent">mR.mL</p>
</td>
<td align="left">
<p class="tent">mR.mL.(mB+1).1</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">-</p>
</td>
<td align="left">
<p class="tent">R &lt; mR and R does not exist</p>
</td>
<td align="left">
<p class="tent">hR.mL**</p>
</td>
<td align="left">
<p class="tent">hR.mL.(mB+1).1</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">-</p>
</td>
<td align="left">
<p class="tent">Trunk successor in release &gt; R and R exists</p>
</td>
<td align="left">
<p class="tent">R.mL</p>
</td>
<td align="left">
<p class="tent">R.mL.(mB+1).1</p>
</td>
</tr>

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

<tr valign="top">
<td align="left">
<p class="tent">R.L</p>
</td>
<td align="center">
<p class="tent">yes</p>
</td>
<td align="left">
<p class="tent">No trunk successor</p>
</td>
<td align="left">
<p class="tent">R.L</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</p>
</td>
<td align="center">
<p class="tent">-</p>
</td>
<td align="left">
<p class="tent">Trunk successor in release &gt;= R</p>
</td>
<td align="left">
<p class="tent">R.L</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</p>
</td>
<td align="center">
<p class="tent">no</p>