vfs: check userland buffers before reading them.
[haiku.git] / docs / userguide / pt_PT / index.html
blob9eb4a61a48cdc5131dc983141326bfe8c7fb7a57
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="pt-PT" xml:lang="pt-PT">
4 <head>
5 <!--
7 * Copyright 2008-2009, Haiku. All rights reserved.
8 * Distributed under the terms of the MIT License.
10 * Authors:
11 * Humdinger <humdingerb@gmail.com>
13 -->
14 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
15 <meta http-equiv="Content-Style-Type" content="text/css" />
16 <meta name="robots" content="all" />
17 <title>Index</title>
18 <meta name="viewport" content="width=device-width, initial-scale=1.0" />
19 <link rel="stylesheet" type="text/css" href="../Haiku-doc.css" />
20 </head>
21 <body>
23 <div id="banner">
24 <div><span>User guide</span></div>
25 </div>
27 <div class="nav">
28 <div class="inner">
29 <ul class="lang-menu">
30 <li class="now"><img src="../images/flags/pt_PT.png" alt="" /> Português</li>
31 <li><a href="../ca/index.html"><img src="../images/flags/ca.png" alt="" />Català</a></li>
32 <li><a href="../de/index.html"><img src="../images/flags/de.png" alt="" />Deutsch</a></li>
33 <li><a href="../en/index.html"><img src="../images/flags/gb.png" alt="" />English</a></li>
34 <li><a href="../es/index.html"><img src="../images/flags/es.png" alt="" />Español</a></li>
35 <li><a href="../fr/index.html"><img src="../images/flags/fr.png" alt="" />Français</a></li>
36 <li><a href="../it/index.html"><img src="../images/flags/it.png" alt="" />Italiano</a></li>
37 <li><a href="../hu/index.html"><img src="../images/flags/hu.png" alt="" />Magyar</a></li>
38 <li><a href="../pl/index.html"><img src="../images/flags/pl.png" alt="" />Polski</a></li>
39 <li><a href="../pt_BR/index.html"><img src="../images/flags/pt_BR.png" alt="" />Português (Brazil)</a></li>
40 <li><a href="../ro/index.html"><img src="../images/flags/ro.png" alt="" />Română</a></li>
41 <li><a href="../sk/index.html"><img src="../images/flags/sk.png" alt="" />Slovenčina</a></li>
42 <li><a href="../fi/index.html"><img src="../images/flags/fi.png" alt="" />Suomi</a></li>
43 <li><a href="../sv_SE/index.html"><img src="../images/flags/sv_SE.png" alt="" />Svenska</a></li>
44 <li><a href="../zh_CN/index.html"><img src="../images/flags/zh_CN.png" alt="" /> 中文 [中文]</a></li>
45 <li><a href="../ru/index.html"><img src="../images/flags/ru.png" alt="" />Русский</a></li>
46 <li><a href="../uk/index.html"><img src="../images/flags/uk.png" alt="" />Українська</a></li>
47 <li><a href="../jp/index.html"><img src="../images/flags/jp.png" alt="" />日本語</a></li>
48 </ul>
49 <span>
50 « <a href="attributes.html">Attributes</a>
51 :: <a href="contents.html" class="uplink">Contents</a>
52 :: <a href="queries.html">Queries</a> »
53 </span></div>
54 </div>
56 <div id="content">
57 <div>
58 <div class="box-info">The translation of this page isn't yet complete. Until it is, unfinished parts use the English original.</div>
60 <h1>Index</h1>
62 <p><a href="attributes.html">Attributes</a> and <a href="queries.html">Queries</a> are key features of Haiku. While attributes are useful on their own, to display additional information on a file, for a query on them, they need to be indexed. It puts them into a lookup table, which in turn makes queries lightning fast.<br />
63 The index is part of the filesystem and is kept for every volume/partition separately.</p>
65 <h2>
66 Indexing commands in Terminal</h2>
67 <p>There are several commands to manage the index:</p>
68 <ul>
69 <li><b>lsindex</b> - Displays the indexed attributes on the current volume/partition.<br />
70 These are the attributes that are indexed by default:</li>
71 </ul>
72 <pre class="terminal"> ~ -&gt;lsindex
73 BEOS:APP_SIG
74 MAIL:account
75 MAIL:cc
76 MAIL:chain
77 MAIL:draft
78 MAIL:flags
79 MAIL:from
80 MAIL:name
81 MAIL:pending_chain
82 MAIL:priority
83 MAIL:reply
84 MAIL:status
85 MAIL:subject
86 MAIL:thread
87 MAIL:to
88 MAIL:when
89 META:address
90 META:city
91 META:company
92 META:country
93 META:email
94 META:fax
95 META:group
96 META:hphone
97 META:name
98 META:nickname
99 META:state
100 META:url
101 META:wphone
102 META:zip
103 _signature
104 _status
105 _trk/qrylastchange
106 _trk/recentQuery
107 be:deskbar_item_status
108 last_modified
109 name
110 size
111 </pre>
112 <ul>
113 <li><b>mkindex</b> - Adds an attribute to the index of a volume/partition. </li>
114 </ul>
115 <pre>Usage: mkindex [options] &lt;attribute&gt;
116 Creates a new index for the specified attribute.
118 -d, --volume=PATH a path on the volume to which the index will be added,
119 defaults to current volume.
120 -t, --type=TYPE the type of the attribute being indexed. One of "int",
121 "llong", "string", "float", or "double".
122 Defaults to "string".
123 --copy-from path to volume to copy the indexes from.
124 -v, --verbose print information about the index being created
126 </pre>
127 <p>Only <b>new</b> files with that attribute come automatically into the index!<br />
128 Existing files have to be added manually by copying them and deleting the originals after that. Alternatively you can use the command <span class="cli">reindex</span>.
129 </p>
130 <ul>
131 <li><b>reindex</b> - Puts the attributes of existing files into the newly created index of a volume/partition. </li>
132 </ul>
133 <pre>Usage: reindex [-rvf] attr &lt;list of filenames and/or directories&gt;
134 -r enter directories recursively
135 -v verbose output
136 -f create/update all indices from the source volume,
137 "attr" is the path to the source volume
139 </pre>
140 <ul>
141 <li><b>rmindex</b> - Removes an attribute from the index of a volume/partition.</li>
142 </ul>
143 <pre>Usage: rmindex [OPTION]... INDEX_NAME
145 Removes the index named INDEX_NAME from a disk volume. Once this has been
146 done, it will no longer be possible to use the query system to search for
147 files with the INDEX_NAME attribute.
149 -d, --volume=PATH a path on the volume from which the index will be
150 removed
151 -h, --help display this help and exit
152 -p, --pattern INDEX_NAME is a pattern
153 -v, --verbose print information about the index being removed
155 INDEX_NAME is the name of a file attribute.
157 If no volume is specified, the volume of the current directory is assumed.</pre>
159 </div>
160 </div>
162 <div class="nav">
163 <div class="inner"><span>
164 « <a href="attributes.html">Attributes</a>
165 :: <a href="contents.html" class="uplink">Contents</a>
166 :: <a href="queries.html">Queries</a> »
167 </span></div>
168 </div>
170 </body>
171 </html>