Final tidy up.

include/cdio/xa.h

@@ -1,5 +1,5 @@
 /*
-    $Id: xa.h,v 1.2 2003/08/31 08:32:40 rocky Exp $
+    $Id: xa.h,v 1.3 2003/08/31 09:11:25 rocky Exp $
 
     Copyright (C) 2000 Herbert Valerio Riedel <hvr@gnu.org>
     Copyright (C) 2003 Rocky Bernstein <rocky@panix.com>
@@ -18,6 +18,12 @@
     along with this program; if not, write to the Free Software
     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
+
+#ifndef __CDIO_XA_H__
+#define __CDIO_XA_H__
+
+#define ISO_XA_MARKER_STRING    "CD-XA001"
+#define ISO_XA_MARKER_OFFSET    1024
 
 /* XA attribute definitions */
 #define XA_ATTR_U_READ         (1 << 0)
@@ -60,7 +66,47 @@ struct iso9660_xa /* big endian!! */
 } GNUC_PACKED;
 
 
+/*!
+  Returns a string which interpreting the extended attribute xa_attr. 
+  For example:
+  \verbatim
+  d---1xrxrxr
+  ---2--r-r-r
+  -a--1xrxrxr
+  \endverbatim
+  
+  A description of the characters in the string follows
+  The 1st character is either "d" if the entry is a directory, or "-" if not
+  The 2nd character is either "a" if the entry is CDDA (audio), or "-" if not
+  The 3rd character is either "i" if the entry is interleaved, or "-" if not
+  The 4th character is either "2" if the entry is mode2 form2 or "-" if not
+  The 5th character is either "1" if the entry is mode2 form1 or "-" if not
+  Note that an entry will either be in mode2 form1 or mode form2. That
+  is you will either see "2-" or "-1" in the 4th & 5th positions.
+  
+  The 6th and 7th characters refer to permissions for everyone while the
+  the 8th and 9th characters refer to permissions for a group while, and 
+  the 10th and 11th characters refer to permissions for a user. 
+  
+  In each of these pairs the first character (6, 8, 10) is "x" if the 
+  entry is executable. For a directory this means the directory is
+  allowed to be listed or "searched".
+  The second character of a pair (7, 9, 11) is "r" if the entry is allowed
+  to be read. 
+*/
+const char *
+iso9660_get_xa_attr_str (uint16_t xa_attr);
+  
 iso9660_xa_t *
 iso9660_xa_init (iso9660_xa_t *_xa, uint16_t uid, uint16_t gid, uint16_t attr, 
 		 uint8_t filenum);
 
+#endif /* __CDIO_XA_H__ */
+
+/* 
+ * Local variables:
+ *  c-file-style: "gnu"
+ *  tab-width: 8
+ *  indent-tabs-mode: nil
+ * End:
+ */