← Back to branch summary

~ubuntu-branches/ubuntu/natty/evolution-data-server/natty

« back to all changes in this revision

Viewing changes to docs/reference/camel/html/camel-camel-lock.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-03-01 22:47:15 UTC
  • mfrom: (1.1.77 upstream)
  • Revision ID: james.westby@ubuntu.com-20100301224715-drsxc2y3t8anz3c0
Tags: 2.28.3-0ubuntu1
https://launchpad.net/bugs/455020
https://launchpad.net/bugs/475147
https://launchpad.net/bugs/305428
https://launchpad.net/bugs/341909
https://launchpad.net/bugs/444177
* New upstream version:
  Bug Fixes:
  - #602723 - Contact list name doesn't get displayed in 'To' dialog 
  - #600322 - assertion failed: (reply == msg) in cs_waitinfo()
              (lp: #455020, #475147)
  - #564727 - Few memory leaks (lp: #305428)
  - #574940 - Always ref returned info from message_info_from_uid 
              (lp: #341909)
  - #429317 - Use the relative URI returned if the server 
              re-directs a request
  - #602820 - Test validity of a book_view before using it in LDAP 
  - #590762 - Recurring google calendar items are not changeable
  - #604236 - Slow GPG processing 
  - #597816 - Do not crash on incorrect parameters used in sexp to SQL 
              (lp: #444177)
  - #604544 - Try Exchange fallback authentication only once 
  - #600778 - Fix --enable-e2k-debug configure option resolution 
  - #260407 - 'endswith' address book search doesn't work 
  - #549221 - (bnc) delete, sync flags immediately
* debian/patches/99_reconfigure.patch:
  - new version update

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/camel/html/camel-camel-lock.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>camel-lock</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
7
7
<link rel="home" href="index.html" title="Camel Reference Manual">
8
8
<link rel="up" href="Utilities.html" title="Utilities">
9
9
<link rel="prev" href="camel-camel-list-utils.html" title="camel-list-utils">
10
10
<link rel="next" href="camel-camel-lock-client.html" title="camel-lock-client">
11
 
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
 
<link rel="part" href="classes.html" title="Part I. Camel Classes">
14
 
<link rel="chapter" href="ClassTree.html" title="Class Hierarchy">
15
 
<link rel="chapter" href="Fundamentals.html" title="Fundamentals">
16
 
<link rel="chapter" href="Streams.html" title="Streams">
17
 
<link rel="chapter" href="StreamFilters.html" title="Stream Filters">
18
 
<link rel="chapter" href="Services.html" title="Services">
19
 
<link rel="chapter" href="Filters.html" title="Filters">
20
 
<link rel="chapter" href="Folders.html" title="Folders">
21
 
<link rel="chapter" href="SearchFolders.html" title="Search Folders">
22
 
<link rel="chapter" href="Addresses.html" title="Addresses">
23
 
<link rel="chapter" href="Crypto.html" title="Crypto Contexts">
24
 
<link rel="chapter" href="MIME.html" title="MIME Objects">
25
 
<link rel="chapter" href="Storage.html" title="Metadata Storage">
26
 
<link rel="chapter" href="Utilities.html" title="Utilities">
27
 
<link rel="chapter" href="Deprecated.html" title="Deprecated Objects">
28
 
<link rel="index" href="ix01.html" title="Index">
29
 
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
30
13
</head>
31
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
32
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
39
22
</tr>
40
23
<tr><td colspan="5" class="shortcuts">
41
24
<a href="#camel-camel-lock.synopsis" class="shortcut">Top</a>
42
 
                 | 
43
 
                <a href="#camel-camel-lock.description" class="shortcut">Description</a>
 
25
                   | 
 
26
                  <a href="#camel-camel-lock.description" class="shortcut">Description</a>
44
27
</td></tr>
45
28
</table>
46
 
<div class="refentry" title="camel-lock">
 
29
<div class="refentry" lang="en">
47
30
<a name="camel-camel-lock"></a><div class="titlepage"></div>
48
31
<div class="refnamediv"><table width="100%"><tr>
49
32
<td valign="top">
52
35
</td>
53
36
<td valign="top" align="right"></td>
54
37
</tr></table></div>
55
 
<div class="refsynopsisdiv" title="Synopsis">
 
38
<div class="refsynopsisdiv">
56
39
<a name="camel-camel-lock.synopsis"></a><h2>Synopsis</h2>
57
 
<pre class="synopsis">
58
 
#define             <a class="link" href="camel-camel-lock.html#CAMEL-LOCK-DOT-RETRY--CAPS" title="CAMEL_LOCK_DOT_RETRY">CAMEL_LOCK_DOT_RETRY</a>
59
 
#define             <a class="link" href="camel-camel-lock.html#CAMEL-LOCK-DOT-DELAY--CAPS" title="CAMEL_LOCK_DOT_DELAY">CAMEL_LOCK_DOT_DELAY</a>
60
 
#define             <a class="link" href="camel-camel-lock.html#CAMEL-LOCK-DOT-STALE--CAPS" title="CAMEL_LOCK_DOT_STALE">CAMEL_LOCK_DOT_STALE</a>
61
 
#define             <a class="link" href="camel-camel-lock.html#CAMEL-LOCK-RETRY--CAPS" title="CAMEL_LOCK_RETRY">CAMEL_LOCK_RETRY</a>
62
 
#define             <a class="link" href="camel-camel-lock.html#CAMEL-LOCK-DELAY--CAPS" title="CAMEL_LOCK_DELAY">CAMEL_LOCK_DELAY</a>
 
40
<pre class="synopsis">#define             <a class="link" href="camel-camel-lock.html#CAMEL-LOCK-DOT-RETRY:CAPS" title="CAMEL_LOCK_DOT_RETRY">CAMEL_LOCK_DOT_RETRY</a>
 
41
#define             <a class="link" href="camel-camel-lock.html#CAMEL-LOCK-DOT-DELAY:CAPS" title="CAMEL_LOCK_DOT_DELAY">CAMEL_LOCK_DOT_DELAY</a>
 
42
#define             <a class="link" href="camel-camel-lock.html#CAMEL-LOCK-DOT-STALE:CAPS" title="CAMEL_LOCK_DOT_STALE">CAMEL_LOCK_DOT_STALE</a>
 
43
#define             <a class="link" href="camel-camel-lock.html#CAMEL-LOCK-RETRY:CAPS" title="CAMEL_LOCK_RETRY">CAMEL_LOCK_RETRY</a>
 
44
#define             <a class="link" href="camel-camel-lock.html#CAMEL-LOCK-DELAY:CAPS" title="CAMEL_LOCK_DELAY">CAMEL_LOCK_DELAY</a>
63
45
enum                <a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType">CamelLockType</a>;
64
 
<a
65
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
66
 
>gint</a>                <a class="link" href="camel-camel-lock.html#camel-lock-dot" title="camel_lock_dot ()">camel_lock_dot</a>                      (const <a
67
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
68
 
>gchar</a> *path,
69
 
                                                         <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
70
 
<a
71
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
72
 
>gint</a>                <a class="link" href="camel-camel-lock.html#camel-lock-fcntl" title="camel_lock_fcntl ()">camel_lock_fcntl</a>                    (<a
73
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
74
 
>gint</a> fd,
75
 
                                                         <a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType">CamelLockType</a> type,
76
 
                                                         <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
77
 
<a
78
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
79
 
>gint</a>                <a class="link" href="camel-camel-lock.html#camel-lock-flock" title="camel_lock_flock ()">camel_lock_flock</a>                    (<a
80
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
81
 
>gint</a> fd,
82
 
                                                         <a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType">CamelLockType</a> type,
83
 
                                                         <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
84
 
void                <a class="link" href="camel-camel-lock.html#camel-unlock-dot" title="camel_unlock_dot ()">camel_unlock_dot</a>                    (const <a
85
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
86
 
>gchar</a> *path);
87
 
void                <a class="link" href="camel-camel-lock.html#camel-unlock-fcntl" title="camel_unlock_fcntl ()">camel_unlock_fcntl</a>                  (<a
88
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
89
 
>gint</a> fd);
90
 
void                <a class="link" href="camel-camel-lock.html#camel-unlock-flock" title="camel_unlock_flock ()">camel_unlock_flock</a>                  (<a
91
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
92
 
>gint</a> fd);
93
 
<a
94
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
95
 
>gint</a>                <a class="link" href="camel-camel-lock.html#camel-lock-folder" title="camel_lock_folder ()">camel_lock_folder</a>                   (const <a
96
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
97
 
>gchar</a> *path,
98
 
                                                         <a
99
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
100
 
>gint</a> fd,
101
 
                                                         <a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType">CamelLockType</a> type,
102
 
                                                         <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
103
 
void                <a class="link" href="camel-camel-lock.html#camel-unlock-folder" title="camel_unlock_folder ()">camel_unlock_folder</a>                 (const <a
104
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
105
 
>gchar</a> *path,
106
 
                                                         <a
107
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
108
 
>gint</a> fd);
 
46
<span class="returnvalue">gint</span>                <a class="link" href="camel-camel-lock.html#camel-lock-dot" title="camel_lock_dot ()">camel_lock_dot</a>                      (<em class="parameter"><code>const <span class="type">gchar</span> *path</code></em>,
 
47
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);
 
48
<span class="returnvalue">gint</span>                <a class="link" href="camel-camel-lock.html#camel-lock-fcntl" title="camel_lock_fcntl ()">camel_lock_fcntl</a>                    (<em class="parameter"><code><span class="type">gint</span> fd</code></em>,
 
49
                                                         <em class="parameter"><code><a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType"><span class="type">CamelLockType</span></a> type</code></em>,
 
50
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);
 
51
<span class="returnvalue">gint</span>                <a class="link" href="camel-camel-lock.html#camel-lock-flock" title="camel_lock_flock ()">camel_lock_flock</a>                    (<em class="parameter"><code><span class="type">gint</span> fd</code></em>,
 
52
                                                         <em class="parameter"><code><a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType"><span class="type">CamelLockType</span></a> type</code></em>,
 
53
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);
 
54
<span class="returnvalue">void</span>                <a class="link" href="camel-camel-lock.html#camel-unlock-dot" title="camel_unlock_dot ()">camel_unlock_dot</a>                    (<em class="parameter"><code>const <span class="type">gchar</span> *path</code></em>);
 
55
<span class="returnvalue">void</span>                <a class="link" href="camel-camel-lock.html#camel-unlock-fcntl" title="camel_unlock_fcntl ()">camel_unlock_fcntl</a>                  (<em class="parameter"><code><span class="type">gint</span> fd</code></em>);
 
56
<span class="returnvalue">void</span>                <a class="link" href="camel-camel-lock.html#camel-unlock-flock" title="camel_unlock_flock ()">camel_unlock_flock</a>                  (<em class="parameter"><code><span class="type">gint</span> fd</code></em>);
 
57
<span class="returnvalue">gint</span>                <a class="link" href="camel-camel-lock.html#camel-lock-folder" title="camel_lock_folder ()">camel_lock_folder</a>                   (<em class="parameter"><code>const <span class="type">gchar</span> *path</code></em>,
 
58
                                                         <em class="parameter"><code><span class="type">gint</span> fd</code></em>,
 
59
                                                         <em class="parameter"><code><a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType"><span class="type">CamelLockType</span></a> type</code></em>,
 
60
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);
 
61
<span class="returnvalue">void</span>                <a class="link" href="camel-camel-lock.html#camel-unlock-folder" title="camel_unlock_folder ()">camel_unlock_folder</a>                 (<em class="parameter"><code>const <span class="type">gchar</span> *path</code></em>,
 
62
                                                         <em class="parameter"><code><span class="type">gint</span> fd</code></em>);
109
63
</pre>
110
64
</div>
111
 
<div class="refsect1" title="Description">
 
65
<div class="refsect1" lang="en">
112
66
<a name="camel-camel-lock.description"></a><h2>Description</h2>
113
67
<p>
114
68
</p>
115
69
</div>
116
 
<div class="refsect1" title="Details">
 
70
<div class="refsect1" lang="en">
117
71
<a name="camel-camel-lock.details"></a><h2>Details</h2>
118
 
<div class="refsect2" title="CAMEL_LOCK_DOT_RETRY">
119
 
<a name="CAMEL-LOCK-DOT-RETRY--CAPS"></a><h3>CAMEL_LOCK_DOT_RETRY</h3>
 
72
<div class="refsect2" lang="en">
 
73
<a name="CAMEL-LOCK-DOT-RETRY:CAPS"></a><h3>CAMEL_LOCK_DOT_RETRY</h3>
120
74
<pre class="programlisting">#define CAMEL_LOCK_DOT_RETRY (5) /* number of times to retry lock */
121
75
</pre>
122
76
<p>
123
77
</p>
124
78
</div>
125
79
<hr>
126
 
<div class="refsect2" title="CAMEL_LOCK_DOT_DELAY">
127
 
<a name="CAMEL-LOCK-DOT-DELAY--CAPS"></a><h3>CAMEL_LOCK_DOT_DELAY</h3>
 
80
<div class="refsect2" lang="en">
 
81
<a name="CAMEL-LOCK-DOT-DELAY:CAPS"></a><h3>CAMEL_LOCK_DOT_DELAY</h3>
128
82
<pre class="programlisting">#define CAMEL_LOCK_DOT_DELAY (2) /* delay between locking retries */
129
83
</pre>
130
84
<p>
131
85
</p>
132
86
</div>
133
87
<hr>
134
 
<div class="refsect2" title="CAMEL_LOCK_DOT_STALE">
135
 
<a name="CAMEL-LOCK-DOT-STALE--CAPS"></a><h3>CAMEL_LOCK_DOT_STALE</h3>
 
88
<div class="refsect2" lang="en">
 
89
<a name="CAMEL-LOCK-DOT-STALE:CAPS"></a><h3>CAMEL_LOCK_DOT_STALE</h3>
136
90
<pre class="programlisting">#define CAMEL_LOCK_DOT_STALE (60) /* seconds before a lock becomes stale */
137
91
</pre>
138
92
<p>
139
93
</p>
140
94
</div>
141
95
<hr>
142
 
<div class="refsect2" title="CAMEL_LOCK_RETRY">
143
 
<a name="CAMEL-LOCK-RETRY--CAPS"></a><h3>CAMEL_LOCK_RETRY</h3>
 
96
<div class="refsect2" lang="en">
 
97
<a name="CAMEL-LOCK-RETRY:CAPS"></a><h3>CAMEL_LOCK_RETRY</h3>
144
98
<pre class="programlisting">#define CAMEL_LOCK_RETRY (5) /* number of times to retry lock */
145
99
</pre>
146
100
<p>
147
101
</p>
148
102
</div>
149
103
<hr>
150
 
<div class="refsect2" title="CAMEL_LOCK_DELAY">
151
 
<a name="CAMEL-LOCK-DELAY--CAPS"></a><h3>CAMEL_LOCK_DELAY</h3>
 
104
<div class="refsect2" lang="en">
 
105
<a name="CAMEL-LOCK-DELAY:CAPS"></a><h3>CAMEL_LOCK_DELAY</h3>
152
106
<pre class="programlisting">#define CAMEL_LOCK_DELAY (2) /* delay between locking retries */
153
107
</pre>
154
108
<p>
155
109
</p>
156
110
</div>
157
111
<hr>
158
 
<div class="refsect2" title="enum CamelLockType">
 
112
<div class="refsect2" lang="en">
159
113
<a name="CamelLockType"></a><h3>enum CamelLockType</h3>
160
114
<pre class="programlisting">typedef enum {
161
115
        CAMEL_LOCK_READ,
166
120
</p>
167
121
</div>
168
122
<hr>
169
 
<div class="refsect2" title="camel_lock_dot ()">
 
123
<div class="refsect2" lang="en">
170
124
<a name="camel-lock-dot"></a><h3>camel_lock_dot ()</h3>
171
 
<pre class="programlisting"><a
172
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
173
 
>gint</a>                camel_lock_dot                      (const <a
174
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
175
 
>gchar</a> *path,
176
 
                                                         <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
 
125
<pre class="programlisting"><span class="returnvalue">gint</span>                camel_lock_dot                      (<em class="parameter"><code>const <span class="type">gchar</span> *path</code></em>,
 
126
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);</pre>
177
127
<p>
178
128
Create an exclusive lock using .lock semantics.
179
129
All locks are equivalent to write locks (exclusive).</p>
180
 
<p>
181
 
</p>
182
130
<div class="variablelist"><table border="0">
183
131
<col align="left" valign="top">
184
 
<tbody>
185
 
<tr>
186
 
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
187
 
<td>
188
 
</td>
189
 
</tr>
190
 
<tr>
191
 
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
192
 
<td>
193
 
</td>
194
 
</tr>
195
 
<tr>
 
132
<tbody><tr>
196
133
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
197
134
<td> -1 on error, sets <em class="parameter"><code>ex</code></em> appropriately.
198
135
</td>
199
 
</tr>
200
 
</tbody>
 
136
</tr></tbody>
201
137
</table></div>
202
138
</div>
203
139
<hr>
204
 
<div class="refsect2" title="camel_lock_fcntl ()">
 
140
<div class="refsect2" lang="en">
205
141
<a name="camel-lock-fcntl"></a><h3>camel_lock_fcntl ()</h3>
206
 
<pre class="programlisting"><a
207
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
208
 
>gint</a>                camel_lock_fcntl                    (<a
209
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
210
 
>gint</a> fd,
211
 
                                                         <a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType">CamelLockType</a> type,
212
 
                                                         <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
 
142
<pre class="programlisting"><span class="returnvalue">gint</span>                camel_lock_fcntl                    (<em class="parameter"><code><span class="type">gint</span> fd</code></em>,
 
143
                                                         <em class="parameter"><code><a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType"><span class="type">CamelLockType</span></a> type</code></em>,
 
144
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);</pre>
213
145
<p>
214
146
Create a lock using fcntl(2).
215
147
</p>
216
148
<p>
217
149
<em class="parameter"><code>type</code></em> is CAMEL_LOCK_WRITE or CAMEL_LOCK_READ,
218
150
to create exclusive or shared read locks</p>
219
 
<p>
220
 
</p>
221
151
<div class="variablelist"><table border="0">
222
152
<col align="left" valign="top">
223
 
<tbody>
224
 
<tr>
225
 
<td><p><span class="term"><em class="parameter"><code>fd</code></em> :</span></p></td>
226
 
<td>
227
 
</td>
228
 
</tr>
229
 
<tr>
230
 
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
231
 
<td>
232
 
</td>
233
 
</tr>
234
 
<tr>
235
 
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
236
 
<td>
237
 
</td>
238
 
</tr>
239
 
<tr>
 
153
<tbody><tr>
240
154
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
241
155
<td> -1 on error.
242
156
</td>
243
 
</tr>
244
 
</tbody>
 
157
</tr></tbody>
245
158
</table></div>
246
159
</div>
247
160
<hr>
248
 
<div class="refsect2" title="camel_lock_flock ()">
 
161
<div class="refsect2" lang="en">
249
162
<a name="camel-lock-flock"></a><h3>camel_lock_flock ()</h3>
250
 
<pre class="programlisting"><a
251
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
252
 
>gint</a>                camel_lock_flock                    (<a
253
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
254
 
>gint</a> fd,
255
 
                                                         <a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType">CamelLockType</a> type,
256
 
                                                         <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
 
163
<pre class="programlisting"><span class="returnvalue">gint</span>                camel_lock_flock                    (<em class="parameter"><code><span class="type">gint</span> fd</code></em>,
 
164
                                                         <em class="parameter"><code><a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType"><span class="type">CamelLockType</span></a> type</code></em>,
 
165
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);</pre>
257
166
<p>
258
167
Create a lock using flock(2).
259
168
</p>
260
169
<p>
261
170
<em class="parameter"><code>type</code></em> is CAMEL_LOCK_WRITE or CAMEL_LOCK_READ,
262
171
to create exclusive or shared read locks</p>
263
 
<p>
264
 
</p>
265
172
<div class="variablelist"><table border="0">
266
173
<col align="left" valign="top">
267
 
<tbody>
268
 
<tr>
269
 
<td><p><span class="term"><em class="parameter"><code>fd</code></em> :</span></p></td>
270
 
<td>
271
 
</td>
272
 
</tr>
273
 
<tr>
274
 
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
275
 
<td>
276
 
</td>
277
 
</tr>
278
 
<tr>
279
 
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
280
 
<td>
281
 
</td>
282
 
</tr>
283
 
<tr>
 
174
<tbody><tr>
284
175
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
285
176
<td> -1 on error.
286
177
</td>
287
 
</tr>
288
 
</tbody>
 
178
</tr></tbody>
289
179
</table></div>
290
180
</div>
291
181
<hr>
292
 
<div class="refsect2" title="camel_unlock_dot ()">
 
182
<div class="refsect2" lang="en">
293
183
<a name="camel-unlock-dot"></a><h3>camel_unlock_dot ()</h3>
294
 
<pre class="programlisting">void                camel_unlock_dot                    (const <a
295
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
296
 
>gchar</a> *path);</pre>
 
184
<pre class="programlisting"><span class="returnvalue">void</span>                camel_unlock_dot                    (<em class="parameter"><code>const <span class="type">gchar</span> *path</code></em>);</pre>
297
185
<p>
298
186
Attempt to unlock a .lock lock.</p>
299
 
<p>
300
 
</p>
301
 
<div class="variablelist"><table border="0">
302
 
<col align="left" valign="top">
303
 
<tbody><tr>
304
 
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
305
 
<td>
306
 
</td>
307
 
</tr></tbody>
308
 
</table></div>
309
187
</div>
310
188
<hr>
311
 
<div class="refsect2" title="camel_unlock_fcntl ()">
 
189
<div class="refsect2" lang="en">
312
190
<a name="camel-unlock-fcntl"></a><h3>camel_unlock_fcntl ()</h3>
313
 
<pre class="programlisting">void                camel_unlock_fcntl                  (<a
314
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
315
 
>gint</a> fd);</pre>
 
191
<pre class="programlisting"><span class="returnvalue">void</span>                camel_unlock_fcntl                  (<em class="parameter"><code><span class="type">gint</span> fd</code></em>);</pre>
316
192
<p>
317
193
Unlock an fcntl lock.</p>
318
 
<p>
319
 
</p>
320
 
<div class="variablelist"><table border="0">
321
 
<col align="left" valign="top">
322
 
<tbody><tr>
323
 
<td><p><span class="term"><em class="parameter"><code>fd</code></em> :</span></p></td>
324
 
<td>
325
 
</td>
326
 
</tr></tbody>
327
 
</table></div>
328
194
</div>
329
195
<hr>
330
 
<div class="refsect2" title="camel_unlock_flock ()">
 
196
<div class="refsect2" lang="en">
331
197
<a name="camel-unlock-flock"></a><h3>camel_unlock_flock ()</h3>
332
 
<pre class="programlisting">void                camel_unlock_flock                  (<a
333
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
334
 
>gint</a> fd);</pre>
 
198
<pre class="programlisting"><span class="returnvalue">void</span>                camel_unlock_flock                  (<em class="parameter"><code><span class="type">gint</span> fd</code></em>);</pre>
335
199
<p>
336
200
Unlock an flock lock.</p>
337
 
<p>
338
 
</p>
339
 
<div class="variablelist"><table border="0">
340
 
<col align="left" valign="top">
341
 
<tbody><tr>
342
 
<td><p><span class="term"><em class="parameter"><code>fd</code></em> :</span></p></td>
343
 
<td>
344
 
</td>
345
 
</tr></tbody>
346
 
</table></div>
347
201
</div>
348
202
<hr>
349
 
<div class="refsect2" title="camel_lock_folder ()">
 
203
<div class="refsect2" lang="en">
350
204
<a name="camel-lock-folder"></a><h3>camel_lock_folder ()</h3>
351
 
<pre class="programlisting"><a
352
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
353
 
>gint</a>                camel_lock_folder                   (const <a
354
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
355
 
>gchar</a> *path,
356
 
                                                         <a
357
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
358
 
>gint</a> fd,
359
 
                                                         <a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType">CamelLockType</a> type,
360
 
                                                         <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
 
205
<pre class="programlisting"><span class="returnvalue">gint</span>                camel_lock_folder                   (<em class="parameter"><code>const <span class="type">gchar</span> *path</code></em>,
 
206
                                                         <em class="parameter"><code><span class="type">gint</span> fd</code></em>,
 
207
                                                         <em class="parameter"><code><a class="link" href="camel-camel-lock.html#CamelLockType" title="enum CamelLockType"><span class="type">CamelLockType</span></a> type</code></em>,
 
208
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);</pre>
361
209
<p>
362
210
Attempt to lock a folder, multiple attempts will be made using all
363
211
locking strategies available.</p>
364
 
<p>
365
 
</p>
366
212
<div class="variablelist"><table border="0">
367
213
<col align="left" valign="top">
368
214
<tbody>
369
215
<tr>
370
216
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
371
 
<td> Path to the file to lock (used for .locking only).
 
217
<td>Path to the file to lock (used for .locking only).
372
218
</td>
373
219
</tr>
374
220
<tr>
375
221
<td><p><span class="term"><em class="parameter"><code>fd</code></em> :</span></p></td>
376
 
<td> Open file descriptor of the right type to lock.
 
222
<td>Open file descriptor of the right type to lock.
377
223
</td>
378
224
</tr>
379
225
<tr>
380
226
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
381
 
<td> Type of lock, CAMEL_LOCK_READ or CAMEL_LOCK_WRITE.
382
 
</td>
383
 
</tr>
384
 
<tr>
385
 
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
386
 
<td>
 
227
<td>Type of lock, CAMEL_LOCK_READ or CAMEL_LOCK_WRITE.
387
228
</td>
388
229
</tr>
389
230
<tr>
395
236
</table></div>
396
237
</div>
397
238
<hr>
398
 
<div class="refsect2" title="camel_unlock_folder ()">
 
239
<div class="refsect2" lang="en">
399
240
<a name="camel-unlock-folder"></a><h3>camel_unlock_folder ()</h3>
400
 
<pre class="programlisting">void                camel_unlock_folder                 (const <a
401
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
402
 
>gchar</a> *path,
403
 
                                                         <a
404
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
405
 
>gint</a> fd);</pre>
 
241
<pre class="programlisting"><span class="returnvalue">void</span>                camel_unlock_folder                 (<em class="parameter"><code>const <span class="type">gchar</span> *path</code></em>,
 
242
                                                         <em class="parameter"><code><span class="type">gint</span> fd</code></em>);</pre>
406
243
<p>
407
244
Free a lock on a folder.</p>
408
 
<p>
409
 
</p>
410
245
<div class="variablelist"><table border="0">
411
246
<col align="left" valign="top">
412
247
<tbody>
413
248
<tr>
414
249
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
415
 
<td> Filename of folder.
 
250
<td>Filename of folder.
416
251
</td>
417
252
</tr>
418
253
<tr>
419
254
<td><p><span class="term"><em class="parameter"><code>fd</code></em> :</span></p></td>
420
 
<td> Open descrptor on which locks were placed.
 
255
<td>Open descrptor on which locks were placed.
421
256
</td>
422
257
</tr>
423
258
</tbody>
427
262
</div>
428
263
<div class="footer">
429
264
<hr>
430
 
          Generated by GTK-Doc V1.11</div>
 
265
          Generated by GTK-Doc V1.14</div>
431
266
</body>
432
 
</html>
 
267
</html>
 
 
b'\\ No newline at end of file'