pax.html

IEEE 1003.1-2003, Single Unix Specification v3

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">646<img src="../images/delta.gif" border="0">1990</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 646:1990</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">1<img src=
"../images/delta.gif" border="0">1998</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-1:1998</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">2<img src=
"../images/delta.gif" border="0">1999</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-2:1999</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">3<img src=
"../images/delta.gif" border="0">1999</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-3:1999</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">4<img src=
"../images/delta.gif" border="0">1998</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-4:1998</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">5<img src=
"../images/delta.gif" border="0">1999</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-5:1999</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">6<img src=
"../images/delta.gif" border="0">1999</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-6:1999</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">7<img src=
"../images/delta.gif" border="0">1987</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-7:1987</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">8<img src=
"../images/delta.gif" border="0">1999</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-8:1999</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">9<img src=
"../images/delta.gif" border="0">1999</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-9:1999</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">10<img src=
"../images/delta.gif" border="0">1998</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-10:1998</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">13<img src=
"../images/delta.gif" border="0">1998</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-13:1998</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">14<img src=
"../images/delta.gif" border="0">1998</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-14:1998</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">8859<img src="../images/delta.gif" border="0">15<img src=
"../images/delta.gif" border="0">1999</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 8859-15:1999</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">10646<img src="../images/delta.gif" border="0">2000</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 10646:2000</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">ISO-IR<img src="../images/delta.gif" border="0">10646<img src="../images/delta.gif" border="0">2000<img src=
"../images/delta.gif" border="0">UTF-8</p>
</td>
<td align="left">
<p class="tent">ISO/IEC 10646, UTF-8 encoding</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent">BINARY</p>
</td>
<td align="left">
<p class="tent">None.</p>
</td>
</tr>
</table>
</center>

<p>The encoding is included in an extended header for information only; when <i>pax</i> is used as described in
IEEE&nbsp;Std&nbsp;1003.1-2001, it shall not translate the file data into any other encoding. The <b>BINARY</b> entry indicates
unencoded binary data.</p>

<p>When used in <b>write</b> or <b>copy</b> mode, it is implementation-defined whether <i>pax</i> includes a <b>charset</b>
extended header record for a file.</p>
</dd>

<dt><b>comment</b></dt>

<dd>A series of characters used as a comment. All characters in the &lt;<i>value</i>&gt; field shall be ignored by <i>pax</i>.</dd>

<dt><b>ctime</b></dt>

<dd>The file creation time for the following file(s), equivalent to the value of the <i>st_ctime</i> member of the <b>stat</b>
structure for a file, as described by the <a href="../functions/stat.html"><i>stat</i>()</a> function. The creation time shall be
restored if the process has the appropriate privilege required to do so. The format of the &lt;<i>value</i>&gt; shall be as
described in <a href="#tag_04_100_13_05">pax Extended Header File Times</a> .</dd>

<dt><b>gid</b></dt>

<dd>The group ID of the group that owns the file, expressed as a decimal number using digits from the ISO/IEC&nbsp;646:1991
standard. This record shall override the <i>gid</i> field in the following header block(s). When used in <b>write</b> or
<b>copy</b> mode, <i>pax</i> shall include a <i>gid</i> extended header record for each file whose group ID is greater than 2097151
(octal 7777777).</dd>

<dt><b>gname</b></dt>

<dd>The group of the file(s), formatted as a group name in the group database. This record shall override the <i>gid</i> and
<i>gname</i> fields in the following header block(s), and any <i>gid</i> extended header record. When used in <b>read</b>,
<b>copy</b>, or <b>list</b> mode, <i>pax</i> shall translate the name from the UTF-8 encoding in the header record to the character
set appropriate for the group database on the receiving system. If any of the UTF-8 characters cannot be translated, and if the
<b>-o</b> <b>invalid=</b> UTF-8 option is not specified, the results are implementation-defined. When used in <b>write</b> or
<b>copy</b> mode, <i>pax</i> shall include a <b>gname</b> extended header record for each file whose group name cannot be
represented entirely with the letters and digits of the portable character set.</dd>

<dt><b>linkpath</b></dt>

<dd>The pathname of a link being created to another file, of any type, previously archived. This record shall override the
<i>linkname</i> field in the following <b>ustar</b> header block(s). The following <b>ustar</b> header block shall determine the
type of link created. If <i>typeflag</i> of the following header block is 1, it shall be a hard link. If <i>typeflag</i> is 2, it
shall be a symbolic link and the <b>linkpath</b> value shall be the contents of the symbolic link. The <i>pax</i> utility shall
translate the name of the link (contents of the symbolic link) from the UTF-8 encoding to the character set appropriate for the
local file system. When used in <b>write</b> or <b>copy</b> mode, <i>pax</i> shall include a <b>linkpath</b> extended header record
for each link whose pathname cannot be represented entirely with the members of the portable character set other than NUL.</dd>

<dt><b>mtime</b></dt>

<dd>The file modification time of the following file(s), equivalent to the value of the <i>st_mtime</i> member of the <b>stat</b>
structure for a file, as described in the <a href="../functions/stat.html"><i>stat</i>()</a> function. This record shall override
the <i>mtime</i> field in the following header block(s). The modification time shall be restored if the process has the appropriate
privilege required to do so. The format of the &lt;<i>value</i>&gt; shall be as described in <a href="#tag_04_100_13_05">pax
Extended Header File Times</a> .</dd>

<dt><b>path</b></dt>

<dd>The pathname of the following file(s). This record shall override the <i>name</i> and <i>prefix</i> fields in the following
header block(s). The <i>pax</i> utility shall translate the pathname of the file from the UTF-8 encoding to the character set
appropriate for the local file system. 

<p>When used in <b>write</b> or <b>copy</b> mode, <i>pax</i> shall include a <i>path</i> extended header record for each file whose
pathname cannot be represented entirely with the members of the portable character set other than NUL.</p>
</dd>

<dt><b>realtime.</b><i>any</i></dt>

<dd>The keywords prefixed by &quot;realtime.&quot; are reserved for future standardization.</dd>

<dt><b>security.</b><i>any</i></dt>

<dd>The keywords prefixed by &quot;security.&quot; are reserved for future standardization.</dd>

<dt><b>size</b></dt>

<dd>The size of the file in octets, expressed as a decimal number using digits from the ISO/IEC&nbsp;646:1991 standard. This record
shall override the <i>size</i> field in the following header block(s). When used in <b>write</b> or <b>copy</b> mode, <i>pax</i>
shall include a <i>size</i> extended header record for each file with a size value greater than 8589934591 (octal
77777777777).</dd>

<dt><b>uid</b></dt>

<dd>The user ID of the file owner, expressed as a decimal number using digits from the ISO/IEC&nbsp;646:1991 standard. This record
shall override the <i>uid</i> field in the following header block(s). When used in <b>write</b> or <b>copy</b> mode, <i>pax</i>
shall include a <i>uid</i> extended header record for each file whose owner ID is greater than 2097151 (octal 7777777).</dd>

<dt><b>uname</b></dt>

<dd>The owner of the following file(s), formatted as a user name in the user database. This record shall override the <i>uid</i>
and <i>uname</i> fields in the following header block(s), and any <i>uid</i> extended header record. When used in <b>read</b>,
<b>copy</b>, or <b>list</b> mode, <i>pax</i> shall translate the name from the UTF-8 encoding in the header record to the character
set appropriate for the user database on the receiving system. If any of the UTF-8 characters cannot be translated, and if the
<b>-o</b> <b>invalid=</b> UTF-8 option is not specified, the results are implementation-defined. When used in <b>write</b> or
<b>copy</b> mode, <i>pax</i> shall include a <b>uname</b> extended header record for each file whose user name cannot be
represented entirely with the letters and digits of the portable character set.</dd>
</dl>

<p>If the &lt;<i>value</i>&gt; field is zero length, it shall delete any header block field, previously entered extended header
value, or global extended header value of the same name.</p>

<p>If a keyword in an extended header record (or in a <b>-o</b> option-argument) overrides or deletes a corresponding field in the
<b>ustar</b> header block, <i>pax</i> shall ignore the contents of that header block field.</p>

<p>Unlike the <b>u