/usr/share/doc/lire/dev-manual/ch07.html is in lire-devel-doc 2:2.1.1-2.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 7. Common Textual Elements to All XML Formats</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="Lire Developer's Manual"><link rel="up" href="pt03.html" title="Part III. Developer's Reference"><link rel="prev" href="ch06.html" title="Chapter 6. Lire Data Types"><link rel="next" href="ch08.html" title="Chapter 8. The Lire Report Configuration Specification Markup Language"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 7. Common Textual Elements to All XML Formats </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch06.html">Prev</a> </td><th width="60%" align="center">Part III. Developer's Reference</th><td width="20%" align="right"> <a accesskey="n" href="ch08.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 7. Common Textual Elements to All XML Formats"><div class="titlepage"><div><div><h2 class="title"><a name="chap:lire-desc-doc"></a>Chapter 7. Common Textual Elements to All XML Formats </h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch07.html#id405096">Lire Data Types Parameter Entities</a></span></dt><dd><dl><dt><span class="section"><a href="ch07.html#id405111">Boolean Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405162">Integer Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405181">Number Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405201">String Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405220">Timestamp type</a></span></dt><dt><span class="section"><a href="ch07.html#id405241">Time Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405261">Date Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405282">Duration Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405338">IP Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405357">Port Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405384">Hostname Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405404">URL Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405423">Email Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405443">Bytes Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405477">Filename Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405497">Field Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405525">Superservice Type</a></span></dt><dt><span class="section"><a href="ch07.html#id405546">Related Types</a></span></dt></dl></dd></dl></div><div class="section" title="Lire Data Types Parameter Entities"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id405096"></a>Lire Data Types Parameter Entities</h2></div></div></div><p>This module contains the parameter entity declarations for
the data types used by all Lire DTDs.
</p><p>All defined data types have a
<em class="parameter"><code><type>.type</code></em> parameter entity which
defines their type as an XML type valid in an attribute declaration
and a <em class="parameter"><code><type>.name</code></em> parameter entity
that declare their name.
</p><p>Additionally, this module declares <name>.types parameter
entities that group related types together.
</p><p>The latest version of that module is
<span class="productnumber">1.0</span> and its public
identifier is <span class="productname">-//LogReport.ORG//ENTITIES Lire Data
Types V1.0//EN</span>™.
</p><div class="section" title="Boolean Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405111"></a>Boolean Type</h3></div></div></div><p>The <span class="type">bool</span> type. It contains a boolean value,
either <code class="literal">0</code>, <code class="literal">1</code>,
<code class="literal">f</code>, <code class="literal">t</code>,
<code class="literal">false</code> or <code class="literal">true</code>.
</p><pre class="programlisting">
<!ENTITY % bool.type "0 | 1 | f | t | false | true | yes | no">
<!ENTITY % bool.name "bool" >
</pre></div><div class="section" title="Integer Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405162"></a>Integer Type</h3></div></div></div><p>The <span class="type">int</span> type can contains positive or negative
32 bits integer.
</p><pre class="programlisting">
<!ENTITY % int.type "CDATA" >
<!ENTITY % int.name "int" >
</pre></div><div class="section" title="Number Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405181"></a>Number Type</h3></div></div></div><p>The <span class="type">number</span> type can contains any number either
integral or floating point.</p><pre class="programlisting">
<!ENTITY % number.type "CDATA" >
<!ENTITY % number.name "number" >
</pre></div><div class="section" title="String Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405201"></a>String Type</h3></div></div></div><p>The <span class="type">string</span> type contains any displayable text
string.</p><pre class="programlisting">
<!ENTITY % string.type "CDATA" >
<!ENTITY % string.name "string" >
</pre></div><div class="section" title="Timestamp type"><div class="titlepage"><div><div><h3 class="title"><a name="id405220"></a>Timestamp type</h3></div></div></div><p>The <span class="type">timestamp</span> type contains a time
representation which contains the date and time informations. It
can be represented in UNIX epoch time.
</p><pre class="programlisting">
<!ENTITY % timestamp.type "CDATA" >
<!ENTITY % timestamp.name "timestamp" >
</pre></div><div class="section" title="Time Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405241"></a>Time Type</h3></div></div></div><p>The <span class="type">time</span> type contains a time representation
which contains only the time of the day, not the date. For
example, this data type can represent 12h00, 15:13:10, etc.
</p><pre class="programlisting">
<!ENTITY % time.type "CDATA" >
<!ENTITY % time.name "time" >
</pre></div><div class="section" title="Date Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405261"></a>Date Type</h3></div></div></div><p>The <span class="type">date</span> type contains a time representation
which contains only a date.
</p><pre class="programlisting">
<!ENTITY % date.type "CDATA" >
<!ENTITY % date.name "date" >
</pre></div><div class="section" title="Duration Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405282"></a>Duration Type</h3></div></div></div><p>The <span class="type">duration</span> type contains a quantity of time.
For example : <code class="literal">5s</code>, <code class="literal">30h</code>,
<code class="literal">2days</code>, <code class="literal">3w</code>,
<code class="literal">2M</code>, <code class="literal">1y</code>. (The authoritive
list of supported duration types is coded in
<code class="function">Lire::DataTypes::duration2sec</code>.)
</p><pre class="programlisting">
<!ENTITY % duration.type "CDATA" >
<!ENTITY % duration.name "duration" >
</pre></div><div class="section" title="IP Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405338"></a>IP Type</h3></div></div></div><p>The <span class="type">ip</span> type contains an IPv4 address.</p><pre class="programlisting">
<!ENTITY % ip.type "CDATA" >
<!ENTITY % ip.name "ip" >
</pre></div><div class="section" title="Port Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405357"></a>Port Type</h3></div></div></div><p>The <span class="type">port</span> type contains a port as used in the TCP
to name the ends of logical connections. See also RFC 1700 and
<a class="ulink" href="http://www.iana.org/numbers.htm" target="_top">http://www.iana.org/numbers.htm</a>.
Commonly found in /etc/services on Unix systems.
</p><pre class="programlisting">
<!ENTITY % port.type "CDATA" >
<!ENTITY % port.name "port" >
</pre></div><div class="section" title="Hostname Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405384"></a>Hostname Type</h3></div></div></div><p>The <span class="type">hostname</span> type contains an DNS hostname. (It
can also contains the IPv4 address of the host).
</p><pre class="programlisting">
<!ENTITY % hostname.type "NMTOKEN" >
<!ENTITY % hostname.name "hostname" >
</pre></div><div class="section" title="URL Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405404"></a>URL Type</h3></div></div></div><p>The <span class="type">url</span> type represents URL.</p><pre class="programlisting">
<!ENTITY % url.type "CDATA" >
<!ENTITY % url.name "url" >
</pre></div><div class="section" title="Email Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405423"></a>Email Type</h3></div></div></div><p> The <span class="type">email</span> type can be used to represent an
email address.
</p><pre class="programlisting">
<!ENTITY % email.type "CDATA" >
<!ENTITY % email.name "email" >
</pre></div><div class="section" title="Bytes Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405443"></a>Bytes Type</h3></div></div></div><p>The <span class="type">bytes</span> type can be used to represent quantity
of data. (<code class="literal">5m</code>, <code class="literal">1.2g</code>,
300bytes<code class="literal"></code>, etc.)
</p><pre class="programlisting">
<!ENTITY % bytes.type "CDATA" >
<!ENTITY % bytes.name "bytes" >
</pre></div><div class="section" title="Filename Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405477"></a>Filename Type</h3></div></div></div><p>The <span class="type">filename</span>type can be used to Represent the
name of a file or directory.
</p><pre class="programlisting">
<!ENTITY % filename.type "CDATA" >
<!ENTITY % filename.name "filename" >
</pre></div><div class="section" title="Field Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405497"></a>Field Type</h3></div></div></div><div class="important" title="Important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>This type should be considered internal to Lire and
shouldn't be used as a parameter or DLF field type.
</p></div><p>The <span class="type">field</span> type can contains a DLF field name. It
is used in the parameter specification to represent a choice of
sort field for example.
</p><pre class="programlisting">
<!ENTITY % field.type "NMTOKEN" >
<!ENTITY % field.name "field" >
</pre></div><div class="section" title="Superservice Type"><div class="titlepage"><div><div><h3 class="title"><a name="id405525"></a>Superservice Type</h3></div></div></div><div class="important" title="Important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>This type should be considered internal to Lire and
shouldn't be used as a parameter or DLF field type.
</p></div><pre class="programlisting">
<!ENTITY % superservice.type "NMTOKEN" >
<!ENTITY % superservice.name "superservice" >
</pre></div><div class="section" title="Related Types"><div class="titlepage"><div><div><h3 class="title"><a name="id405546"></a>Related Types</h3></div></div></div><pre class="programlisting">
<!ENTITY % basic.types "%bool.name; | %int.name; |
%number.name; | %string.name;" >
<!ENTITY % internet.types "%email.name; | %url.name; |
%ip.name; | %hostname.name; |
%port.name;" >
<!ENTITY % misc.types "%filename.name; | %bytes.name; " >
<!ENTITY % time.types "%date.name; | %time.name; |
%timestamp.name; | %duration.name;" >
<!ENTITY % lire.types "%basic.types; | %time.types; |
%internet.types; | %misc.types;" >
</pre></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch06.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pt03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch08.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 6. Lire Data Types </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 8. The Lire Report Configuration Specification Markup Language</td></tr></table></div></body></html>
|