<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <!--Converted with LaTeX2HTML 2008 (1.71) original version by: Nikos Drakos, CBLU, University of Leeds * revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan * with significant contributions from: Jens Lippmann, Marek Rouchal, Martin Wilck and others --> <HTML> <HEAD> <TITLE>Unix File Attributes</TITLE> <META NAME="description" CONTENT="Unix File Attributes"> <META NAME="keywords" CONTENT="developers"> <META NAME="resource-type" CONTENT="document"> <META NAME="distribution" CONTENT="global"> <META NAME="Generator" CONTENT="LaTeX2HTML v2008"> <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> <LINK REL="STYLESHEET" HREF="developers.css"> <LINK REL="next" HREF="Old_Depreciated_Tape_Format.html"> <LINK REL="previous" HREF="Overall_Storage_Format.html"> <LINK REL="up" HREF="Storage_Media_Output_Format.html"> <LINK REL="next" HREF="Old_Depreciated_Tape_Format.html"> </HEAD> <BODY > <!--Navigation Panel--> <A NAME="tex2html1233" HREF="Old_Depreciated_Tape_Format.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html1227" HREF="Storage_Media_Output_Format.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html1221" HREF="Overall_Storage_Format.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html1229" HREF="Contents.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <A NAME="tex2html1231" HREF="GNU_Free_Documentation_Lice.html"> <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> <BR> <B> Next:</B> <A NAME="tex2html1234" HREF="Old_Depreciated_Tape_Format.html">Old Depreciated Tape Format</A> <B> Up:</B> <A NAME="tex2html1228" HREF="Storage_Media_Output_Format.html">Storage Media Output Format</A> <B> Previous:</B> <A NAME="tex2html1222" HREF="Overall_Storage_Format.html">Overall Storage Format</A> <B> <A NAME="tex2html1230" HREF="Contents.html">Contents</A></B> <B> <A NAME="tex2html1232" HREF="GNU_Free_Documentation_Lice.html">Index</A></B> <BR> <BR> <!--End of Navigation Panel--> <H1><A NAME="SECTION0011130000000000000000"></A> <A NAME="3991"></A> <A NAME="3992"></A> <BR> Unix File Attributes </H1> <P> The Unix File Attributes packet consists of the following: <P> File-Index Type Filename@File-Attributes@Link @Extended-Attributes@ where <P> <DL> <DT><STRONG>@</STRONG></DT> <DD>represents a byte containing a binary zero. <P> </DD> <DT><STRONG>FileIndex</STRONG></DT> <DD><A NAME="4009"></A> is the sequential file index starting from one assigned by the File daemon. <P> </DD> <DT><STRONG>Type</STRONG></DT> <DD><A NAME="4010"></A> is one of the following: <P> <PRE> #define FT_LNKSAVED 1 /* hard link to file already saved */ #define FT_REGE 2 /* Regular file but empty */ #define FT_REG 3 /* Regular file */ #define FT_LNK 4 /* Soft Link */ #define FT_DIR 5 /* Directory */ #define FT_SPEC 6 /* Special file -- chr, blk, fifo, sock */ #define FT_NOACCESS 7 /* Not able to access */ #define FT_NOFOLLOW 8 /* Could not follow link */ #define FT_NOSTAT 9 /* Could not stat file */ #define FT_NOCHG 10 /* Incremental option, file not changed */ #define FT_DIRNOCHG 11 /* Incremental option, directory not changed */ #define FT_ISARCH 12 /* Trying to save archive file */ #define FT_NORECURSE 13 /* No recursion into directory */ #define FT_NOFSCHG 14 /* Different file system, prohibited */ #define FT_NOOPEN 15 /* Could not open directory */ #define FT_RAW 16 /* Raw block device */ #define FT_FIFO 17 /* Raw fifo device */ </PRE> <P> </DD> <DT><STRONG>Filename</STRONG></DT> <DD><A NAME="4013"></A> is the fully qualified filename. <P> </DD> <DT><STRONG>File-Attributes</STRONG></DT> <DD><A NAME="4014"></A> consists of the 13 fields of the stat() buffer in ASCII base64 format separated by spaces. These fields and their meanings are shown below. This stat() packet is in Unix format, and MUST be provided (constructed) for ALL systems. <P> </DD> <DT><STRONG>Link</STRONG></DT> <DD><A NAME="4015"></A> when the FT code is FT_LNK or FT_LNKSAVED, the item in question is a Unix link, and this field contains the fully qualified link name. When the FT code is not FT_LNK or FT_LNKSAVED, this field is null. <P> </DD> <DT><STRONG>Extended-Attributes</STRONG></DT> <DD><A NAME="4016"></A> The exact format of this field is operating system dependent. It contains additional or extended attributes of a system dependent nature. Currently, this field is used only on WIN32 systems where it contains a ASCII base64 representation of the WIN32_FILE_ATTRIBUTE_DATA structure as defined by Windows. The fields in the base64 representation of this structure are like the File-Attributes separated by spaces. </DD> </DL> <P> The File-attributes consist of the following: <P> <TABLE CELLPADDING=3 BORDER="1"> <TR><TD ALIGN="CENTER" COLSPAN=1><B>Field No. </B></TD> <TD ALIGN="CENTER" COLSPAN=1><B>Stat Name </B></TD> <TD ALIGN="CENTER" COLSPAN=1><B>Unix </B></TD> <TD ALIGN="CENTER" COLSPAN=1><B>Win98/NT </B></TD> <TD ALIGN="CENTER" COLSPAN=1><B>MacOS </B></TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>1</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_dev</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Device number of filesystem</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Drive number</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>vRefNum</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>2</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_ino</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Inode number</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Always 0</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>fileID/dirID</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>3</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_mode</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>File mode</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>File mode</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>777 dirs/apps; 666 docs; 444 locked docs</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>4</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_nlink</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Number of links to the file</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Number of link (only on NTFS)</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>Always 1</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>5</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_uid</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Owner ID</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Always 0</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>Always 0</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>6</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_gid</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Group ID</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Always 0</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>Always 0</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>7</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_rdev</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Device ID for special files</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Drive No.</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>Always 0</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>8</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_size</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>File size in bytes</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>File size in bytes</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>Data fork file size in bytes</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>9</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_blksize</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Preferred block size</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Always 0</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>Preferred block size</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>10</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_blocks</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Number of blocks allocated</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Always 0</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>Number of blocks allocated</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>11</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_atime</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Last access time since epoch</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Last access time since epoch</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>Last access time -66 years</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>12</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_mtime</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Last modify time since epoch</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Last modify time since epoch</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>Last access time -66 years</TD> </TR> <TR><TD ALIGN="CENTER" COLSPAN=1>13</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=50>st_ctime</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>Inode change time since epoch</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=72>File create time since epoch</TD> <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=101>File create time -66 years</TD> </TR> </TABLE> <P> <HR> <!--Navigation Panel--> <A NAME="tex2html1233" HREF="Old_Depreciated_Tape_Format.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html1227" HREF="Storage_Media_Output_Format.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html1221" HREF="Overall_Storage_Format.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html1229" HREF="Contents.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <A NAME="tex2html1231" HREF="GNU_Free_Documentation_Lice.html"> <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> <BR> <B> Next:</B> <A NAME="tex2html1234" HREF="Old_Depreciated_Tape_Format.html">Old Depreciated Tape Format</A> <B> Up:</B> <A NAME="tex2html1228" HREF="Storage_Media_Output_Format.html">Storage Media Output Format</A> <B> Previous:</B> <A NAME="tex2html1222" HREF="Overall_Storage_Format.html">Overall Storage Format</A> <B> <A NAME="tex2html1230" HREF="Contents.html">Contents</A></B> <B> <A NAME="tex2html1232" HREF="GNU_Free_Documentation_Lice.html">Index</A></B> <!--End of Navigation Panel--> <ADDRESS> 2012-01-24 </ADDRESS> </BODY> </HTML>
