« back to all changes in this revision
Viewing changes to docs/reference/html/libuser-user.html
- browse files at revision 1.1.1
- compare with another revision
- download diff
- download tarball
- view history from revision 1.1.1
- Committer: Bazaar Package Importer
- Author(s): Pierre Habouzit
- Date: 2006-09-03 21:58:15 UTC
- mto: (2.1.1 edgy) (1.1.5 upstream) (3.1.1 lenny)
- mto: This revision was merged to the branch mainline in revision 3.
- Revision ID: james.westby@ubuntu.com-20060903215815-rtvvfzhaer8ymyp4
Tags: upstream-0.54.6-2.1.dfsg.1
Import upstream version 0.54.6-2.1.dfsg.1
- files added:
- docs/libuser.conf.5.in
- files removed:
- libuser.conf.in
- files modified:
- ABOUT-NLS
added
removed
docs/reference/html/libuser-user.html
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>user</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="libuser Reference Manual"><link rel="up" href="ch01.html" title="libuser"><link rel="prev" href="libuser-quota.html" title="quota"><meta name="generator" content="GTK-Doc V1.3 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="chapter" href="ch01.html" title="libuser"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libuser-quota.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">libuser Reference Manual</th></tr></table><div class="refentry" lang="en"><a name="libuser-user"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><span class="refentrytitle">user</span></h2><p>user —
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html>
3
<head>
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>user</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
7
<link rel="start" href="index.html" title="libuser Reference Manual">
8
<link rel="up" href="ch01.html" title="libuser">
9
<link rel="prev" href="libuser-quota.html" title="quota">
10
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
11
<link rel="stylesheet" href="style.css" type="text/css">
12
<link rel="chapter" href="ch01.html" title="libuser">
13
</head>
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
<tr valign="middle">
17
<td><a accesskey="p" href="libuser-quota.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
<th width="100%" align="center">libuser Reference Manual</th>
21
<td> </td>
22
</tr>
23
<tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>
24
 | 
25
<a href="#desc" class="shortcut">Description</a></nobr></td></tr>
26
</table>
27
<div class="refentry" lang="en">
28
<a name="libuser-user"></a><div class="titlepage"></div>
29
<div class="refnamediv"><table width="100%"><tr>
30
<td valign="top">
31
<h2><span class="refentrytitle"><a name="top_of_page"></a>user</span></h2>
32
<p>user —
2
33
Functions for initializing the library, looking up information, and making
3
changes to the system information store.</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
34
changes to the system information store.</p>
35
</td>
36
<td valign="top" align="right"></td>
37
</tr></table></div>
38
<div class="refsynopsisdiv">
39
<a name="synopsis"></a><h2>Synopsis</h2>
40
<pre class="synopsis">
4
41
5
42
6
43
201
238
>GPtrArray</a>* <a href="libuser-user.html#lu-groups-enumerate-full">lu_groups_enumerate_full</a> (lu_context_t *context,
202
239
const char *pattern,
203
240
lu_error_t **error);
204
</pre></div><div class="refsect1" lang="en"><a name="id2732343"></a><h2>Description</h2><p>
241
</pre>
242
</div>
243
<div class="refsect1" lang="en">
244
<a name="desc"></a><h2>Description</h2>
245
<p>
205
246
206
247
user.h contains declarations for functions which start up and shut down the
207
248
libuser library, and for functions which perform lookup queries and
208
249
modifications of the system information store.
209
250
210
</p></div><div class="refsect1" lang="en"><a name="id2732356"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2732362"></a><h3><a name="lu-start"></a>lu_start ()</h3><a class="indexterm" name="id2732372"></a><pre class="programlisting">lu_context_t* lu_start (const char *authname,
251
</p>
252
</div>
253
<div class="refsect1" lang="en">
254
<a name="details"></a><h2>Details</h2>
255
<div class="refsect2" lang="en">
256
<a name="id3078984"></a><h3>
257
<a name="lu-start"></a>lu_start ()</h3>
258
<a class="indexterm" name="id3078995"></a><pre class="programlisting">lu_context_t* lu_start (const char *authname,
211
259
lu_entity_type_t auth_type,
212
260
const char *modules,
213
261
const char *create_modules,
215
263
<a
216
264
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
217
265
>gpointer</a> callback_data,
218
lu_error_t **error);</pre><p>
266
lu_error_t **error);</pre>
267
<p>
219
268
Initializes the libuser library.
220
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>authname</code></em>�:</span></td><td>suggested client name to use when connecting to servers, or <code class="literal">NULL</code>
221
</td></tr><tr><td><span class="term"><em class="parameter"><code>auth_type</code></em>�:</span></td><td>whether auth_name is a user or a group
222
</td></tr><tr><td><span class="term"><em class="parameter"><code>modules</code></em>�:</span></td><td>a list of modules to use for queries (separated by whitespace or
223
commas), or <code class="literal">NULL</code> to use modules specified in the config file
224
</td></tr><tr><td><span class="term"><em class="parameter"><code>create_modules</code></em>�:</span></td><td>a list of modules to use for entity creation (separated by
225
whitespace or commas), or <code class="literal">NULL</code> to use modules specified in the config file
226
</td></tr><tr><td><span class="term"><em class="parameter"><code>prompter</code></em>�:</span></td><td>a function to use for getting information from the user
227
</td></tr><tr><td><span class="term"><em class="parameter"><code>callback_data</code></em>�:</span></td><td>data for <em class="parameter"><code>prompter</code></em>
228
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
229
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td>a context which should be freed by <a href="libuser-user.html#lu-end"><code class="function">lu_end()</code></a> on success, <code class="literal">NULL</code> on
269
</p>
270
<div class="variablelist"><table border="0">
271
<col align="left" valign="top">
272
<tbody>
273
<tr>
274
<td>
275
<span class="term"><em class="parameter"><code>authname</code></em> :</span></td>
276
<td>suggested client name to use when connecting to servers, or <a
277
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
278
><code class="literal">NULL</code></a>
279
</td>
280
</tr>
281
<tr>
282
<td>
283
<span class="term"><em class="parameter"><code>auth_type</code></em> :</span></td>
284
<td>whether auth_name is a user or a group
285
</td>
286
</tr>
287
<tr>
288
<td>
289
<span class="term"><em class="parameter"><code>modules</code></em> :</span></td>
290
<td>a list of modules to use for queries (separated by whitespace or
291
commas), or <a
292
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
293
><code class="literal">NULL</code></a> to use modules specified in the config file
294
</td>
295
</tr>
296
<tr>
297
<td>
298
<span class="term"><em class="parameter"><code>create_modules</code></em> :</span></td>
299
<td>a list of modules to use for entity creation (separated by
300
whitespace or commas), or <a
301
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
302
><code class="literal">NULL</code></a> to use modules specified in the config file
303
</td>
304
</tr>
305
<tr>
306
<td>
307
<span class="term"><em class="parameter"><code>prompter</code></em> :</span></td>
308
<td>a function to use for getting information from the user
309
</td>
310
</tr>
311
<tr>
312
<td>
313
<span class="term"><em class="parameter"><code>callback_data</code></em> :</span></td>
314
<td>data for <em class="parameter"><code>prompter</code></em>
315
</td>
316
</tr>
317
<tr>
318
<td>
319
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
320
<td>filled with a <span class="type">lu_error</span> if an error occurs
321
</td>
322
</tr>
323
<tr>
324
<td>
325
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
326
<td>a context which should be freed by <a href="libuser-user.html#lu-end"><code class="function">lu_end()</code></a> on success, <a
327
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
328
><code class="literal">NULL</code></a> on
230
329
failure
231
330
232
331
233
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2732614"></a><h3><a name="lu-end"></a>lu_end ()</h3><a class="indexterm" name="id2732624"></a><pre class="programlisting">void lu_end (lu_context_t *context);</pre><p>
332
</td>
333
</tr>
334
</tbody>
335
</table></div>
336
</div>
337
<hr>
338
<div class="refsect2" lang="en">
339
<a name="id3079254"></a><h3>
340
<a name="lu-end"></a>lu_end ()</h3>
341
<a class="indexterm" name="id3079266"></a><pre class="programlisting">void lu_end (lu_context_t *context);</pre>
342
<p>
234
343
Destroys a libuser library context
235
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
236
237
238
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2732671"></a><h3><a name="lu-set-prompter"></a>lu_set_prompter ()</h3><a class="indexterm" name="id2732682"></a><pre class="programlisting">void lu_set_prompter (lu_context_t *context,
344
</p>
345
<div class="variablelist"><table border="0">
346
<col align="left" valign="top">
347
<tbody><tr>
348
<td>
349
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
350
<td>a context
351
352
353
</td>
354
</tr></tbody>
355
</table></div>
356
</div>
357
<hr>
358
<div class="refsect2" lang="en">
359
<a name="id3079314"></a><h3>
360
<a name="lu-set-prompter"></a>lu_set_prompter ()</h3>
361
<a class="indexterm" name="id3079326"></a><pre class="programlisting">void lu_set_prompter (lu_context_t *context,
239
362
lu_prompt_fn *prompter,
240
363
<a
241
364
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
242
>gpointer</a> callback_data);</pre><p>
365
>gpointer</a> callback_data);</pre>
366
<p>
243
367
Changes the prompter function in a context
244
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
245
</td></tr><tr><td><span class="term"><em class="parameter"><code>prompter</code></em>�:</span></td><td>a new function to user for getting information from the user
246
</td></tr><tr><td><span class="term"><em class="parameter"><code>callback_data</code></em>�:</span></td><td>data for <em class="parameter"><code>prompter</code></em>
247
248
249
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2732779"></a><h3><a name="lu-get-prompter"></a>lu_get_prompter ()</h3><a class="indexterm" name="id2732789"></a><pre class="programlisting">void lu_get_prompter (lu_context_t *context,
368
</p>
369
<div class="variablelist"><table border="0">
370
<col align="left" valign="top">
371
<tbody>
372
<tr>
373
<td>
374
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
375
<td>a context
376
</td>
377
</tr>
378
<tr>
379
<td>
380
<span class="term"><em class="parameter"><code>prompter</code></em> :</span></td>
381
<td>a new function to user for getting information from the user
382
</td>
383
</tr>
384
<tr>
385
<td>
386
<span class="term"><em class="parameter"><code>callback_data</code></em> :</span></td>
387
<td>data for <em class="parameter"><code>prompter</code></em>
388
389
390
</td>
391
</tr>
392
</tbody>
393
</table></div>
394
</div>
395
<hr>
396
<div class="refsect2" lang="en">
397
<a name="id3079424"></a><h3>
398
<a name="lu-get-prompter"></a>lu_get_prompter ()</h3>
399
<a class="indexterm" name="id3079436"></a><pre class="programlisting">void lu_get_prompter (lu_context_t *context,
250
400
lu_prompt_fn **prompter,
251
401
<a
252
402
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
253
>gpointer</a> *callback_data);</pre><p>
403
>gpointer</a> *callback_data);</pre>
404
<p>
254
405
Gets current prompter function from a context
255
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
256
</td></tr><tr><td><span class="term"><em class="parameter"><code>prompter</code></em>�:</span></td><td>if not <code class="literal">NULL</code>, points to a place where the current prompter function
406
</p>
407
<div class="variablelist"><table border="0">
408
<col align="left" valign="top">
409
<tbody>
410
<tr>
411
<td>
412
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
413
<td>a context
414
</td>
415
</tr>
416
<tr>
417
<td>
418
<span class="term"><em class="parameter"><code>prompter</code></em> :</span></td>
419
<td>if not <a
420
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
421
><code class="literal">NULL</code></a>, points to a place where the current prompter function
257
422
will be stored
258
</td></tr><tr><td><span class="term"><em class="parameter"><code>callback_data</code></em>�:</span></td><td>if not <code class="literal">NULL</code>, points to a place where the current prompter
423
</td>
424
</tr>
425
<tr>
426
<td>
427
<span class="term"><em class="parameter"><code>callback_data</code></em> :</span></td>
428
<td>if not <a
429
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
430
><code class="literal">NULL</code></a>, points to a place where the current prompter
259
431
function data will be stored
260
432
261
433
262
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2732895"></a><h3><a name="lu-set-modules"></a>lu_set_modules ()</h3><a class="indexterm" name="id2732905"></a><pre class="programlisting"><a
434
</td>
435
</tr>
436
</tbody>
437
</table></div>
438
</div>
439
<hr>
440
<div class="refsect2" lang="en">
441
<a name="id3079550"></a><h3>
442
<a name="lu-set-modules"></a>lu_set_modules ()</h3>
443
<a class="indexterm" name="id3079563"></a><pre class="programlisting"><a
263
444
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
264
445
>gboolean</a> lu_set_modules (lu_context_t *context,
265
446
const char *list,
266
lu_error_t **error);</pre><p>
447
lu_error_t **error);</pre>
448
<p>
267
449
Replaces the current set of modules for queries in <em class="parameter"><code>context</code></em> to <em class="parameter"><code>list</code></em>.
268
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
269
</td></tr><tr><td><span class="term"><em class="parameter"><code>list</code></em>�:</span></td><td>a list of modules (separated by whitespace or commas)
270
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
271
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> on failure
272
273
274
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2733038"></a><h3><a name="lu-get-modules"></a>lu_get_modules ()</h3><a class="indexterm" name="id2733048"></a><pre class="programlisting">const char* lu_get_modules (lu_context_t *context);</pre><p>
450
</p>
451
<div class="variablelist"><table border="0">
452
<col align="left" valign="top">
453
<tbody>
454
<tr>
455
<td>
456
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
457
<td>a context
458
</td>
459
</tr>
460
<tr>
461
<td>
462
<span class="term"><em class="parameter"><code>list</code></em> :</span></td>
463
<td>a list of modules (separated by whitespace or commas)
464
</td>
465
</tr>
466
<tr>
467
<td>
468
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
469
<td>filled with a <span class="type">lu_error</span> if an error occurs
470
</td>
471
</tr>
472
<tr>
473
<td>
474
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
475
<td>
476
<a
477
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
478
><code class="literal">TRUE</code></a> on success, <a
479
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
480
><code class="literal">FALSE</code></a> on failure
481
482
483
</td>
484
</tr>
485
</tbody>
486
</table></div>
487
</div>
488
<hr>
489
<div class="refsect2" lang="en">
490
<a name="id3079705"></a><h3>
491
<a name="lu-get-modules"></a>lu_get_modules ()</h3>
492
<a class="indexterm" name="id3079718"></a><pre class="programlisting">const char* lu_get_modules (lu_context_t *context);</pre>
493
<p>
275
494
Returns a list of modules for queries in <em class="parameter"><code>context</code></em>.
276
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
277
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td>a list of modules separated by spaces, or <code class="literal">NULL</code> if the list of
495
</p>
496
<div class="variablelist"><table border="0">
497
<col align="left" valign="top">
498
<tbody>
499
<tr>
500
<td>
501
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
502
<td>a context
503
</td>
504
</tr>
505
<tr>
506
<td>
507
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
508
<td>a list of modules separated by spaces, or <a
509
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
510
><code class="literal">NULL</code></a> if the list of
278
511
modules is empty. The list should not be freed by the caller.
279
512
280
513
281
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2733121"></a><h3><a name="lu-uses-elevated-privileges"></a>lu_uses_elevated_privileges ()</h3><a class="indexterm" name="id2733132"></a><pre class="programlisting"><a
514
</td>
515
</tr>
516
</tbody>
517
</table></div>
518
</div>
519
<hr>
520
<div class="refsect2" lang="en">
521
<a name="id3079795"></a><h3>
522
<a name="lu-uses-elevated-privileges"></a>lu_uses_elevated_privileges ()</h3>
523
<a class="indexterm" name="id3079808"></a><pre class="programlisting"><a
282
524
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
283
>gboolean</a> lu_uses_elevated_privileges (lu_context_t *context);</pre><p>
525
>gboolean</a> lu_uses_elevated_privileges (lu_context_t *context);</pre>
526
<p>
284
527
Checks if any module uses elevated privileges (e.g. modifies files that
285
528
normal users can't modify).
286
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
287
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> if at least one module uses elevated privileges
288
289
290
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2733196"></a><h3><a name="lu-user-lookup-name"></a>lu_user_lookup_name ()</h3><a class="indexterm" name="id2733207"></a><pre class="programlisting"><a
529
</p>
530
<div class="variablelist"><table border="0">
531
<col align="left" valign="top">
532
<tbody>
533
<tr>
534
<td>
535
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
536
<td>a context
537
</td>
538
</tr>
539
<tr>
540
<td>
541
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
542
<td>
543
<a
544
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
545
><code class="literal">TRUE</code></a> if at least one module uses elevated privileges
546
547
548
</td>
549
</tr>
550
</tbody>
551
</table></div>
552
</div>
553
<hr>
554
<div class="refsect2" lang="en">
555
<a name="id3079876"></a><h3>
556
<a name="lu-user-lookup-name"></a>lu_user_lookup_name ()</h3>
557
<a class="indexterm" name="id3079890"></a><pre class="programlisting"><a
291
558
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
292
559
>gboolean</a> lu_user_lookup_name (lu_context_t *context,
293
560
const char *name,
294
561
struct lu_ent *ent,
295
lu_error_t **error);</pre><p>
562
lu_error_t **error);</pre>
563
<p>
296
564
Looks up an user by name.
297
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
298
</td></tr><tr><td><span class="term"><em class="parameter"><code>name</code></em>�:</span></td><td>user name
299
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity filled with received information
300
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
301
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
302
303
304
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2733342"></a><h3><a name="lu-user-lookup-id"></a>lu_user_lookup_id ()</h3><a class="indexterm" name="id2733353"></a><pre class="programlisting"><a
565
</p>
566
<div class="variablelist"><table border="0">
567
<col align="left" valign="top">
568
<tbody>
569
<tr>
570
<td>
571
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
572
<td>a context
573
</td>
574
</tr>
575
<tr>
576
<td>
577
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
578
<td>user name
579
</td>
580
</tr>
581
<tr>
582
<td>
583
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
584
<td>an entity filled with received information
585
</td>
586
</tr>
587
<tr>
588
<td>
589
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
590
<td>filled with a <span class="type">lu_error</span> if an error occurs
591
</td>
592
</tr>
593
<tr>
594
<td>
595
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
596
<td>
597
<a
598
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
599
><code class="literal">TRUE</code></a> on success
600
601
602
</td>
603
</tr>
604
</tbody>
605
</table></div>
606
</div>
607
<hr>
608
<div class="refsect2" lang="en">
609
<a name="id3080029"></a><h3>
610
<a name="lu-user-lookup-id"></a>lu_user_lookup_id ()</h3>
611
<a class="indexterm" name="id3080042"></a><pre class="programlisting"><a
305
612
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
306
613
>gboolean</a> lu_user_lookup_id (lu_context_t *context,
307
614
uid_t uid,
308
615
struct lu_ent *ent,
309
lu_error_t **error);</pre><p>
616
lu_error_t **error);</pre>
617
<p>
310
618
Looks up an user by UID.
311
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
312
</td></tr><tr><td><span class="term"><em class="parameter"><code>uid</code></em>�:</span></td><td>user ID
313
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity filled with received information
314
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
315
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
316
317
318
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2733488"></a><h3><a name="lu-user-default"></a>lu_user_default ()</h3><a class="indexterm" name="id2733498"></a><pre class="programlisting"><a
619
</p>
620
<div class="variablelist"><table border="0">
621
<col align="left" valign="top">
622
<tbody>
623
<tr>
624
<td>
625
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
626
<td>a context
627
</td>
628
</tr>
629
<tr>
630
<td>
631
<span class="term"><em class="parameter"><code>uid</code></em> :</span></td>
632
<td>user ID
633
</td>
634
</tr>
635
<tr>
636
<td>
637
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
638
<td>an entity filled with received information
639
</td>
640
</tr>
641
<tr>
642
<td>
643
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
644
<td>filled with a <span class="type">lu_error</span> if an error occurs
645
</td>
646
</tr>
647
<tr>
648
<td>
649
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
650
<td>
651
<a
652
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
653
><code class="literal">TRUE</code></a> on success
654
655
656
</td>
657
</tr>
658
</tbody>
659
</table></div>
660
</div>
661
<hr>
662
<div class="refsect2" lang="en">
663
<a name="id3080181"></a><h3>
664
<a name="lu-user-default"></a>lu_user_default ()</h3>
665
<a class="indexterm" name="id3080194"></a><pre class="programlisting"><a
319
666
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
320
667
>gboolean</a> lu_user_default (lu_context_t *ctx,
321
668
const char *name,
322
669
<a
323
670
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
324
671
>gboolean</a> system_account,
325
struct lu_ent *ent);</pre><p>
672
struct lu_ent *ent);</pre>
673
<p>
326
674
Fills out an user entity as specified by the config file and modules
327
675
to prepare for creation of the user.
328
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>ctx</code></em>�:</span></td><td>a context
329
</td></tr><tr><td><span class="term"><em class="parameter"><code>name</code></em>�:</span></td><td>new user name
330
</td></tr><tr><td><span class="term"><em class="parameter"><code>system_account</code></em>�:</span></td><td>non-zero if the user is a system user
331
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity
332
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
333
334
335
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2733627"></a><h3><a name="lu-user-add"></a>lu_user_add ()</h3><a class="indexterm" name="id2733638"></a><pre class="programlisting"><a
676
</p>
677
<div class="variablelist"><table border="0">
678
<col align="left" valign="top">
679
<tbody>
680
<tr>
681
<td>
682
<span class="term"><em class="parameter"><code>ctx</code></em> :</span></td>
683
<td>a context
684
</td>
685
</tr>
686
<tr>
687
<td>
688
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
689
<td>new user name
690
</td>
691
</tr>
692
<tr>
693
<td>
694
<span class="term"><em class="parameter"><code>system_account</code></em> :</span></td>
695
<td>non-zero if the user is a system user
696
</td>
697
</tr>
698
<tr>
699
<td>
700
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
701
<td>an entity
702
</td>
703
</tr>
704
<tr>
705
<td>
706
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
707
<td>
708
<a
709
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
710
><code class="literal">TRUE</code></a> on success
711
712
713
</td>
714
</tr>
715
</tbody>
716
</table></div>
717
</div>
718
<hr>
719
<div class="refsect2" lang="en">
720
<a name="id3080327"></a><h3>
721
<a name="lu-user-add"></a>lu_user_add ()</h3>
722
<a class="indexterm" name="id3080340"></a><pre class="programlisting"><a
336
723
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
337
724
>gboolean</a> lu_user_add (lu_context_t *context,
338
725
struct lu_ent *ent,
339
lu_error_t **error);</pre><p>
726
lu_error_t **error);</pre>
727
<p>
340
728
Creates an user in all modules specified for entity creation.
341
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
342
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the user, on success updated with resulting account
343
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
344
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
345
346
347
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2733753"></a><h3><a name="lu-user-modify"></a>lu_user_modify ()</h3><a class="indexterm" name="id2733763"></a><pre class="programlisting"><a
729
</p>
730
<div class="variablelist"><table border="0">
731
<col align="left" valign="top">
732
<tbody>
733
<tr>
734
<td>
735
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
736
<td>a context
737
</td>
738
</tr>
739
<tr>
740
<td>
741
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
742
<td>an entity describing the user, on success updated with resulting account
743
</td>
744
</tr>
745
<tr>
746
<td>
747
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
748
<td>filled with a <span class="type">lu_error</span> if an error occurs
749
</td>
750
</tr>
751
<tr>
752
<td>
753
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
754
<td>
755
<a
756
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
757
><code class="literal">TRUE</code></a> on success
758
759
760
</td>
761
</tr>
762
</tbody>
763
</table></div>
764
</div>
765
<hr>
766
<div class="refsect2" lang="en">
767
<a name="id3080459"></a><h3>
768
<a name="lu-user-modify"></a>lu_user_modify ()</h3>
769
<a class="indexterm" name="id3080472"></a><pre class="programlisting"><a
348
770
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
349
771
>gboolean</a> lu_user_modify (lu_context_t *context,
350
772
struct lu_ent *ent,
351
lu_error_t **error);</pre><p>
773
lu_error_t **error);</pre>
774
<p>
352
775
Modifies an user entity.
353
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
354
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity with pending modifications, on success updated with current
776
</p>
777
<div class="variablelist"><table border="0">
778
<col align="left" valign="top">
779
<tbody>
780
<tr>
781
<td>
782
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
783
<td>a context
784
</td>
785
</tr>
786
<tr>
787
<td>
788
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
789
<td>an entity with pending modifications, on success updated with current
355
790
information
356
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
357
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
358
359
360
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2733878"></a><h3><a name="lu-user-delete"></a>lu_user_delete ()</h3><a class="indexterm" name="id2733888"></a><pre class="programlisting"><a
791
</td>
792
</tr>
793
<tr>
794
<td>
795
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
796
<td>filled with a <span class="type">lu_error</span> if an error occurs
797
</td>
798
</tr>
799
<tr>
800
<td>
801
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
802
<td>
803
<a
804
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
805
><code class="literal">TRUE</code></a> on success
806
807
808
</td>
809
</tr>
810
</tbody>
811
</table></div>
812
</div>
813
<hr>
814
<div class="refsect2" lang="en">
815
<a name="id3080591"></a><h3>
816
<a name="lu-user-delete"></a>lu_user_delete ()</h3>
817
<a class="indexterm" name="id3080603"></a><pre class="programlisting"><a
361
818
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
362
819
>gboolean</a> lu_user_delete (lu_context_t *context,
363
820
struct lu_ent *ent,
364
lu_error_t **error);</pre><p>
821
lu_error_t **error);</pre>
822
<p>
365
823
Deletes an user.
366
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
367
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the user
368
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
369
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
370
371
372
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2734002"></a><h3><a name="lu-user-setpass"></a>lu_user_setpass ()</h3><a class="indexterm" name="id2734012"></a><pre class="programlisting"><a
824
</p>
825
<div class="variablelist"><table border="0">
826
<col align="left" valign="top">
827
<tbody>
828
<tr>
829
<td>
830
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
831
<td>a context
832
</td>
833
</tr>
834
<tr>
835
<td>
836
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
837
<td>an entity describing the user
838
</td>
839
</tr>
840
<tr>
841
<td>
842
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
843
<td>filled with a <span class="type">lu_error</span> if an error occurs
844
</td>
845
</tr>
846
<tr>
847
<td>
848
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
849
<td>
850
<a
851
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
852
><code class="literal">TRUE</code></a> on success
853
854
855
</td>
856
</tr>
857
</tbody>
858
</table></div>
859
</div>
860
<hr>
861
<div class="refsect2" lang="en">
862
<a name="id3080721"></a><h3>
863
<a name="lu-user-setpass"></a>lu_user_setpass ()</h3>
864
<a class="indexterm" name="id3080734"></a><pre class="programlisting"><a
373
865
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
374
866
>gboolean</a> lu_user_setpass (lu_context_t *context,
375
867
struct lu_ent *ent,
377
869
<a
378
870
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
379
871
>gboolean</a> crypted,
380
lu_error_t **error);</pre><p>
872
lu_error_t **error);</pre>
873
<p>
381
874
Changes an user's password.
382
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
383
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the user, on success updated with current
875
</p>
876
<div class="variablelist"><table border="0">
877
<col align="left" valign="top">
878
<tbody>
879
<tr>
880
<td>
881
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
882
<td>a context
883
</td>
884
</tr>
885
<tr>
886
<td>
887
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
888
<td>an entity describing the user, on success updated with current
384
889
information and LU_SHADOWLASTCHANGE
385
</td></tr><tr><td><span class="term"><em class="parameter"><code>newpass</code></em>�:</span></td><td>new password
386
</td></tr><tr><td><span class="term"><em class="parameter"><code>crypted</code></em>�:</span></td><td>non-zero if <em class="parameter"><code>newpass</code></em> is already encrypted
387
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with an <span class="type">lu_error</span> if an error occurs
388
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
389
390
391
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2734176"></a><h3><a name="lu-user-removepass"></a>lu_user_removepass ()</h3><a class="indexterm" name="id2734187"></a><pre class="programlisting"><a
890
</td>
891
</tr>
892
<tr>
893
<td>
894
<span class="term"><em class="parameter"><code>newpass</code></em> :</span></td>
895
<td>new password
896
</td>
897
</tr>
898
<tr>
899
<td>
900
<span class="term"><em class="parameter"><code>crypted</code></em> :</span></td>
901
<td>non-zero if <em class="parameter"><code>newpass</code></em> is already encrypted
902
</td>
903
</tr>
904
<tr>
905
<td>
906
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
907
<td>filled with an <span class="type">lu_error</span> if an error occurs
908
</td>
909
</tr>
910
<tr>
911
<td>
912
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
913
<td>
914
<a
915
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
916
><code class="literal">TRUE</code></a> on success
917
918
919
</td>
920
</tr>
921
</tbody>
922
</table></div>
923
</div>
924
<hr>
925
<div class="refsect2" lang="en">
926
<a name="id3080902"></a><h3>
927
<a name="lu-user-removepass"></a>lu_user_removepass ()</h3>
928
<a class="indexterm" name="id3080915"></a><pre class="programlisting"><a
392
929
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
393
930
>gboolean</a> lu_user_removepass (lu_context_t *context,
394
931
struct lu_ent *ent,
395
lu_error_t **error);</pre><p>
932
lu_error_t **error);</pre>
933
<p>
396
934
Changes an user's password to an empty string.
397
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
398
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the user, on success updated with current
935
</p>
936
<div class="variablelist"><table border="0">
937
<col align="left" valign="top">
938
<tbody>
939
<tr>
940
<td>
941
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
942
<td>a context
943
</td>
944
</tr>
945
<tr>
946
<td>
947
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
948
<td>an entity describing the user, on success updated with current
399
949
information and LU_SHADOWLASTCHANGE
400
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with an <span class="type">lu_error</span> if an error occurs
401
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
402
403
404
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2734302"></a><h3><a name="lu-user-lock"></a>lu_user_lock ()</h3><a class="indexterm" name="id2734312"></a><pre class="programlisting"><a
950
</td>
951
</tr>
952
<tr>
953
<td>
954
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
955
<td>filled with an <span class="type">lu_error</span> if an error occurs
956
</td>
957
</tr>
958
<tr>
959
<td>
960
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
961
<td>
962
<a
963
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
964
><code class="literal">TRUE</code></a> on success
965
966
967
</td>
968
</tr>
969
</tbody>
970
</table></div>
971
</div>
972
<hr>
973
<div class="refsect2" lang="en">
974
<a name="id3081035"></a><h3>
975
<a name="lu-user-lock"></a>lu_user_lock ()</h3>
976
<a class="indexterm" name="id3081047"></a><pre class="programlisting"><a
405
977
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
406
978
>gboolean</a> lu_user_lock (lu_context_t *context,
407
979
struct lu_ent *ent,
408
lu_error_t **error);</pre><p>
980
lu_error_t **error);</pre>
981
<p>
409
982
Locks an user account.
410
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
411
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the user, on success updated with current
983
</p>
984
<div class="variablelist"><table border="0">
985
<col align="left" valign="top">
986
<tbody>
987
<tr>
988
<td>
989
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
990
<td>a context
991
</td>
992
</tr>
993
<tr>
994
<td>
995
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
996
<td>an entity describing the user, on success updated with current
412
997
information
413
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
414
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
415
416
417
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2734427"></a><h3><a name="lu-user-unlock"></a>lu_user_unlock ()</h3><a class="indexterm" name="id2734437"></a><pre class="programlisting"><a
998
</td>
999
</tr>
1000
<tr>
1001
<td>
1002
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1003
<td>filled with a <span class="type">lu_error</span> if an error occurs
1004
</td>
1005
</tr>
1006
<tr>
1007
<td>
1008
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1009
<td>
1010
<a
1011
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1012
><code class="literal">TRUE</code></a> on success
1013
1014
1015
</td>
1016
</tr>
1017
</tbody>
1018
</table></div>
1019
</div>
1020
<hr>
1021
<div class="refsect2" lang="en">
1022
<a name="id3081166"></a><h3>
1023
<a name="lu-user-unlock"></a>lu_user_unlock ()</h3>
1024
<a class="indexterm" name="id3081178"></a><pre class="programlisting"><a
418
1025
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
419
1026
>gboolean</a> lu_user_unlock (lu_context_t *context,
420
1027
struct lu_ent *ent,
421
lu_error_t **error);</pre><p>
1028
lu_error_t **error);</pre>
1029
<p>
422
1030
Unlocks an user account.
423
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
424
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the user, on success updated with current
1031
</p>
1032
<div class="variablelist"><table border="0">
1033
<col align="left" valign="top">
1034
<tbody>
1035
<tr>
1036
<td>
1037
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1038
<td>a context
1039
</td>
1040
</tr>
1041
<tr>
1042
<td>
1043
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1044
<td>an entity describing the user, on success updated with current
425
1045
information
426
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
427
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
428
429
430
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2734551"></a><h3><a name="lu-user-unlock-nonempty"></a>lu_user_unlock_nonempty ()</h3><a class="indexterm" name="id2734562"></a><pre class="programlisting"><a
1046
</td>
1047
</tr>
1048
<tr>
1049
<td>
1050
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1051
<td>filled with a <span class="type">lu_error</span> if an error occurs
1052
</td>
1053
</tr>
1054
<tr>
1055
<td>
1056
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1057
<td>
1058
<a
1059
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1060
><code class="literal">TRUE</code></a> on success
1061
1062
1063
</td>
1064
</tr>
1065
</tbody>
1066
</table></div>
1067
</div>
1068
<hr>
1069
<div class="refsect2" lang="en">
1070
<a name="id3081297"></a><h3>
1071
<a name="lu-user-unlock-nonempty"></a>lu_user_unlock_nonempty ()</h3>
1072
<a class="indexterm" name="id3081310"></a><pre class="programlisting"><a
431
1073
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
432
1074
>gboolean</a> lu_user_unlock_nonempty (lu_context_t *context,
433
1075
struct lu_ent *ent,
434
lu_error_t **error);</pre><p>
1076
lu_error_t **error);</pre>
1077
<p>
435
1078
Unlocks an user account. If unlocking the account would result in an empty
436
1079
password field, it fails with <code class="literal">lu_error_unlock_empty</code>. Note that the
437
1080
password can still be empty.
438
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
439
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the user, on success updated with current
1081
</p>
1082
<div class="variablelist"><table border="0">
1083
<col align="left" valign="top">
1084
<tbody>
1085
<tr>
1086
<td>
1087
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1088
<td>a context
1089
</td>
1090
</tr>
1091
<tr>
1092
<td>
1093
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1094
<td>an entity describing the user, on success updated with current
440
1095
information
441
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
442
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
443
444
445
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2734685"></a><h3><a name="lu-user-islocked"></a>lu_user_islocked ()</h3><a class="indexterm" name="id2734695"></a><pre class="programlisting"><a
1096
</td>
1097
</tr>
1098
<tr>
1099
<td>
1100
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1101
<td>filled with a <span class="type">lu_error</span> if an error occurs
1102
</td>
1103
</tr>
1104
<tr>
1105
<td>
1106
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1107
<td>
1108
<a
1109
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1110
><code class="literal">TRUE</code></a> on success
1111
1112
1113
</td>
1114
</tr>
1115
</tbody>
1116
</table></div>
1117
</div>
1118
<hr>
1119
<div class="refsect2" lang="en">
1120
<a name="id3081443"></a><h3>
1121
<a name="lu-user-islocked"></a>lu_user_islocked ()</h3>
1122
<a class="indexterm" name="id3081456"></a><pre class="programlisting"><a
446
1123
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
447
1124
>gboolean</a> lu_user_islocked (lu_context_t *context,
448
1125
struct lu_ent *ent,
449
lu_error_t **error);</pre><p>
1126
lu_error_t **error);</pre>
1127
<p>
450
1128
Checks if an user account is locked.
451
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
452
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the user
453
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
454
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> if the account is locked in at least one module
455
456
457
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2734810"></a><h3><a name="lu-users-enumerate"></a>lu_users_enumerate ()</h3><a class="indexterm" name="id2734821"></a><pre class="programlisting"><a
1129
</p>
1130
<div class="variablelist"><table border="0">
1131
<col align="left" valign="top">
1132
<tbody>
1133
<tr>
1134
<td>
1135
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1136
<td>a context
1137
</td>
1138
</tr>
1139
<tr>
1140
<td>
1141
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1142
<td>an entity describing the user
1143
</td>
1144
</tr>
1145
<tr>
1146
<td>
1147
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1148
<td>filled with a <span class="type">lu_error</span> if an error occurs
1149
</td>
1150
</tr>
1151
<tr>
1152
<td>
1153
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1154
<td>
1155
<a
1156
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1157
><code class="literal">TRUE</code></a> if the account is locked in at least one module
1158
1159
1160
</td>
1161
</tr>
1162
</tbody>
1163
</table></div>
1164
</div>
1165
<hr>
1166
<div class="refsect2" lang="en">
1167
<a name="id3081575"></a><h3>
1168
<a name="lu-users-enumerate"></a>lu_users_enumerate ()</h3>
1169
<a class="indexterm" name="id3081588"></a><pre class="programlisting"><a
458
1170
href="/usr/share/gtk-doc/html/gobject/gobject-Value-arrays.html#GValueArray"
459
1171
>GValueArray</a>* lu_users_enumerate (lu_context_t *context,
460
1172
const char *pattern,
461
lu_error_t **error);</pre><p>
1173
lu_error_t **error);</pre>
1174
<p>
462
1175
Returns a list of all users matching a pattern.
463
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
464
</td></tr><tr><td><span class="term"><em class="parameter"><code>pattern</code></em>�:</span></td><td>a glob-like pattern for user name
465
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
466
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td>an array of strings, each representing one user name. The array
1176
</p>
1177
<div class="variablelist"><table border="0">
1178
<col align="left" valign="top">
1179
<tbody>
1180
<tr>
1181
<td>
1182
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1183
<td>a context
1184
</td>
1185
</tr>
1186
<tr>
1187
<td>
1188
<span class="term"><em class="parameter"><code>pattern</code></em> :</span></td>
1189
<td>a glob-like pattern for user name
1190
</td>
1191
</tr>
1192
<tr>
1193
<td>
1194
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1195
<td>filled with a <span class="type">lu_error</span> if an error occurs
1196
</td>
1197
</tr>
1198
<tr>
1199
<td>
1200
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1201
<td>an array of strings, each representing one user name. The array
467
1202
should be freed by the caller.
468
1203
469
1204
470
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2734932"></a><h3><a name="lu-users-enumerate-by-group"></a>lu_users_enumerate_by_group ()</h3><a class="indexterm" name="id2734943"></a><pre class="programlisting"><a
1205
</td>
1206
</tr>
1207
</tbody>
1208
</table></div>
1209
</div>
1210
<hr>
1211
<div class="refsect2" lang="en">
1212
<a name="id3081699"></a><h3>
1213
<a name="lu-users-enumerate-by-group"></a>lu_users_enumerate_by_group ()</h3>
1214
<a class="indexterm" name="id3081713"></a><pre class="programlisting"><a
471
1215
href="/usr/share/gtk-doc/html/gobject/gobject-Value-arrays.html#GValueArray"
472
1216
>GValueArray</a>* lu_users_enumerate_by_group (lu_context_t *context,
473
1217
const char *group,
474
lu_error_t **error);</pre><p>
1218
lu_error_t **error);</pre>
1219
<p>
475
1220
Returns a list of all members of a group <em class="parameter"><code>group</code></em>.
476
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
477
</td></tr><tr><td><span class="term"><em class="parameter"><code>group</code></em>�:</span></td><td>group name
478
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
479
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td>an array of strings, each representing one user name. The array
1221
</p>
1222
<div class="variablelist"><table border="0">
1223
<col align="left" valign="top">
1224
<tbody>
1225
<tr>
1226
<td>
1227
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1228
<td>a context
1229
</td>
1230
</tr>
1231
<tr>
1232
<td>
1233
<span class="term"><em class="parameter"><code>group</code></em> :</span></td>
1234
<td>group name
1235
</td>
1236
</tr>
1237
<tr>
1238
<td>
1239
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1240
<td>filled with a <span class="type">lu_error</span> if an error occurs
1241
</td>
1242
</tr>
1243
<tr>
1244
<td>
1245
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1246
<td>an array of strings, each representing one user name. The array
480
1247
should be freed by the caller.
481
1248
482
1249
483
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2735059"></a><h3><a name="lu-users-enumerate-full"></a>lu_users_enumerate_full ()</h3><a class="indexterm" name="id2735070"></a><pre class="programlisting"><a
1250
</td>
1251
</tr>
1252
</tbody>
1253
</table></div>
1254
</div>
1255
<hr>
1256
<div class="refsect2" lang="en">
1257
<a name="id3081829"></a><h3>
1258
<a name="lu-users-enumerate-full"></a>lu_users_enumerate_full ()</h3>
1259
<a class="indexterm" name="id3081841"></a><pre class="programlisting"><a
484
1260
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
485
1261
>GPtrArray</a>* lu_users_enumerate_full (lu_context_t *context,
486
1262
const char *pattern,
487
lu_error_t **error);</pre><p>
1263
lu_error_t **error);</pre>
1264
<p>
488
1265
Returns a list of entities, one for each user matching a pattern.
489
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
490
</td></tr><tr><td><span class="term"><em class="parameter"><code>pattern</code></em>�:</span></td><td>a glob-like pattern for user name
491
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
492
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td>a list of pointers to user entities. The entities and the
1266
</p>
1267
<div class="variablelist"><table border="0">
1268
<col align="left" valign="top">
1269
<tbody>
1270
<tr>
1271
<td>
1272
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1273
<td>a context
1274
</td>
1275
</tr>
1276
<tr>
1277
<td>
1278
<span class="term"><em class="parameter"><code>pattern</code></em> :</span></td>
1279
<td>a glob-like pattern for user name
1280
</td>
1281
</tr>
1282
<tr>
1283
<td>
1284
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1285
<td>filled with a <span class="type">lu_error</span> if an error occurs
1286
</td>
1287
</tr>
1288
<tr>
1289
<td>
1290
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1291
<td>a list of pointers to user entities. The entities and the
493
1292
list should be freed by the caller.
494
1293
495
1294
496
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2735181"></a><h3><a name="lu-group-lookup-name"></a>lu_group_lookup_name ()</h3><a class="indexterm" name="id2735192"></a><pre class="programlisting"><a
1295
</td>
1296
</tr>
1297
</tbody>
1298
</table></div>
1299
</div>
1300
<hr>
1301
<div class="refsect2" lang="en">
1302
<a name="id3081953"></a><h3>
1303
<a name="lu-group-lookup-name"></a>lu_group_lookup_name ()</h3>
1304
<a class="indexterm" name="id3081966"></a><pre class="programlisting"><a
497
1305
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
498
1306
>gboolean</a> lu_group_lookup_name (lu_context_t *context,
499
1307
const char *name,
500
1308
struct lu_ent *ent,
501
lu_error_t **error);</pre><p>
1309
lu_error_t **error);</pre>
1310
<p>
502
1311
Looks up a group by name.
503
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
504
</td></tr><tr><td><span class="term"><em class="parameter"><code>name</code></em>�:</span></td><td>group name
505
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity filled with received information
506
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
507
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
508
509
510
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2735328"></a><h3><a name="lu-group-lookup-id"></a>lu_group_lookup_id ()</h3><a class="indexterm" name="id2735339"></a><pre class="programlisting"><a
1312
</p>
1313
<div class="variablelist"><table border="0">
1314
<col align="left" valign="top">
1315
<tbody>
1316
<tr>
1317
<td>
1318
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1319
<td>a context
1320
</td>
1321
</tr>
1322
<tr>
1323
<td>
1324
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
1325
<td>group name
1326
</td>
1327
</tr>
1328
<tr>
1329
<td>
1330
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1331
<td>an entity filled with received information
1332
</td>
1333
</tr>
1334
<tr>
1335
<td>
1336
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1337
<td>filled with a <span class="type">lu_error</span> if an error occurs
1338
</td>
1339
</tr>
1340
<tr>
1341
<td>
1342
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1343
<td>
1344
<a
1345
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1346
><code class="literal">TRUE</code></a> on success
1347
1348
1349
</td>
1350
</tr>
1351
</tbody>
1352
</table></div>
1353
</div>
1354
<hr>
1355
<div class="refsect2" lang="en">
1356
<a name="id3082106"></a><h3>
1357
<a name="lu-group-lookup-id"></a>lu_group_lookup_id ()</h3>
1358
<a class="indexterm" name="id3082119"></a><pre class="programlisting"><a
511
1359
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
512
1360
>gboolean</a> lu_group_lookup_id (lu_context_t *context,
513
1361
gid_t gid,
514
1362
struct lu_ent *ent,
515
lu_error_t **error);</pre><p>
1363
lu_error_t **error);</pre>
1364
<p>
516
1365
Looks up a group by GID.
517
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
518
</td></tr><tr><td><span class="term"><em class="parameter"><code>gid</code></em>�:</span></td><td>group ID
519
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity filled with received information
520
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
521
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
522
523
524
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2735473"></a><h3><a name="lu-group-default"></a>lu_group_default ()</h3><a class="indexterm" name="id2735484"></a><pre class="programlisting"><a
1366
</p>
1367
<div class="variablelist"><table border="0">
1368
<col align="left" valign="top">
1369
<tbody>
1370
<tr>
1371
<td>
1372
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1373
<td>a context
1374
</td>
1375
</tr>
1376
<tr>
1377
<td>
1378
<span class="term"><em class="parameter"><code>gid</code></em> :</span></td>
1379
<td>group ID
1380
</td>
1381
</tr>
1382
<tr>
1383
<td>
1384
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1385
<td>an entity filled with received information
1386
</td>
1387
</tr>
1388
<tr>
1389
<td>
1390
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1391
<td>filled with a <span class="type">lu_error</span> if an error occurs
1392
</td>
1393
</tr>
1394
<tr>
1395
<td>
1396
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1397
<td>
1398
<a
1399
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1400
><code class="literal">TRUE</code></a> on success
1401
1402
1403
</td>
1404
</tr>
1405
</tbody>
1406
</table></div>
1407
</div>
1408
<hr>
1409
<div class="refsect2" lang="en">
1410
<a name="id3082258"></a><h3>
1411
<a name="lu-group-default"></a>lu_group_default ()</h3>
1412
<a class="indexterm" name="id3082271"></a><pre class="programlisting"><a
525
1413
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
526
1414
>gboolean</a> lu_group_default (lu_context_t *ctx,
527
1415
const char *name,
528
1416
<a
529
1417
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
530
1418
>gboolean</a> system_account,
531
struct lu_ent *ent);</pre><p>
1419
struct lu_ent *ent);</pre>
1420
<p>
532
1421
Fills out a group entity as specified by the config file and modules
533
1422
to prepare for creation of the group.
534
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>ctx</code></em>�:</span></td><td>a context
535
</td></tr><tr><td><span class="term"><em class="parameter"><code>name</code></em>�:</span></td><td>new group name
536
</td></tr><tr><td><span class="term"><em class="parameter"><code>system_account</code></em>�:</span></td><td>non-zero if the group is a system group
537
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity
538
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
539
540
541
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2735613"></a><h3><a name="lu-group-add"></a>lu_group_add ()</h3><a class="indexterm" name="id2735623"></a><pre class="programlisting"><a
1423
</p>
1424
<div class="variablelist"><table border="0">
1425
<col align="left" valign="top">
1426
<tbody>
1427
<tr>
1428
<td>
1429
<span class="term"><em class="parameter"><code>ctx</code></em> :</span></td>
1430
<td>a context
1431
</td>
1432
</tr>
1433
<tr>
1434
<td>
1435
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
1436
<td>new group name
1437
</td>
1438
</tr>
1439
<tr>
1440
<td>
1441
<span class="term"><em class="parameter"><code>system_account</code></em> :</span></td>
1442
<td>non-zero if the group is a system group
1443
</td>
1444
</tr>
1445
<tr>
1446
<td>
1447
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1448
<td>an entity
1449
</td>
1450
</tr>
1451
<tr>
1452
<td>
1453
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1454
<td>
1455
<a
1456
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1457
><code class="literal">TRUE</code></a> on success
1458
1459
1460
</td>
1461
</tr>
1462
</tbody>
1463
</table></div>
1464
</div>
1465
<hr>
1466
<div class="refsect2" lang="en">
1467
<a name="id3082404"></a><h3>
1468
<a name="lu-group-add"></a>lu_group_add ()</h3>
1469
<a class="indexterm" name="id3082416"></a><pre class="programlisting"><a
542
1470
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
543
1471
>gboolean</a> lu_group_add (lu_context_t *context,
544
1472
struct lu_ent *ent,
545
lu_error_t **error);</pre><p>
1473
lu_error_t **error);</pre>
1474
<p>
546
1475
Creates a group in all modules specified for entity creation.
547
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
548
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the group, on success updated with resulting account
549
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
550
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
551
552
553
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2735738"></a><h3><a name="lu-group-modify"></a>lu_group_modify ()</h3><a class="indexterm" name="id2735748"></a><pre class="programlisting"><a
1476
</p>
1477
<div class="variablelist"><table border="0">
1478
<col align="left" valign="top">
1479
<tbody>
1480
<tr>
1481
<td>
1482
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1483
<td>a context
1484
</td>
1485
</tr>
1486
<tr>
1487
<td>
1488
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1489
<td>an entity describing the group, on success updated with resulting account
1490
</td>
1491
</tr>
1492
<tr>
1493
<td>
1494
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1495
<td>filled with a <span class="type">lu_error</span> if an error occurs
1496
</td>
1497
</tr>
1498
<tr>
1499
<td>
1500
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1501
<td>
1502
<a
1503
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1504
><code class="literal">TRUE</code></a> on success
1505
1506
1507
</td>
1508
</tr>
1509
</tbody>
1510
</table></div>
1511
</div>
1512
<hr>
1513
<div class="refsect2" lang="en">
1514
<a name="id3082536"></a><h3>
1515
<a name="lu-group-modify"></a>lu_group_modify ()</h3>
1516
<a class="indexterm" name="id3082548"></a><pre class="programlisting"><a
554
1517
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
555
1518
>gboolean</a> lu_group_modify (lu_context_t *context,
556
1519
struct lu_ent *ent,
557
lu_error_t **error);</pre><p>
1520
lu_error_t **error);</pre>
1521
<p>
558
1522
Modifies a group entity.
559
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
560
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity with pending modifications, on success updated with current
1523
</p>
1524
<div class="variablelist"><table border="0">
1525
<col align="left" valign="top">
1526
<tbody>
1527
<tr>
1528
<td>
1529
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1530
<td>a context
1531
</td>
1532
</tr>
1533
<tr>
1534
<td>
1535
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1536
<td>an entity with pending modifications, on success updated with current
561
1537
information
562
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
563
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
564
565
566
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2735863"></a><h3><a name="lu-group-delete"></a>lu_group_delete ()</h3><a class="indexterm" name="id2735873"></a><pre class="programlisting"><a
1538
</td>
1539
</tr>
1540
<tr>
1541
<td>
1542
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1543
<td>filled with a <span class="type">lu_error</span> if an error occurs
1544
</td>
1545
</tr>
1546
<tr>
1547
<td>
1548
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1549
<td>
1550
<a
1551
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1552
><code class="literal">TRUE</code></a> on success
1553
1554
1555
</td>
1556
</tr>
1557
</tbody>
1558
</table></div>
1559
</div>
1560
<hr>
1561
<div class="refsect2" lang="en">
1562
<a name="id3082667"></a><h3>
1563
<a name="lu-group-delete"></a>lu_group_delete ()</h3>
1564
<a class="indexterm" name="id3082680"></a><pre class="programlisting"><a
567
1565
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
568
1566
>gboolean</a> lu_group_delete (lu_context_t *context,
569
1567
struct lu_ent *ent,
570
lu_error_t **error);</pre><p>
1568
lu_error_t **error);</pre>
1569
<p>
571
1570
Deletes a group.
572
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
573
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the group
574
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
575
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
576
577
578
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2735987"></a><h3><a name="lu-group-setpass"></a>lu_group_setpass ()</h3><a class="indexterm" name="id2735997"></a><pre class="programlisting"><a
1571
</p>
1572
<div class="variablelist"><table border="0">
1573
<col align="left" valign="top">
1574
<tbody>
1575
<tr>
1576
<td>
1577
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1578
<td>a context
1579
</td>
1580
</tr>
1581
<tr>
1582
<td>
1583
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1584
<td>an entity describing the group
1585
</td>
1586
</tr>
1587
<tr>
1588
<td>
1589
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1590
<td>filled with a <span class="type">lu_error</span> if an error occurs
1591
</td>
1592
</tr>
1593
<tr>
1594
<td>
1595
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1596
<td>
1597
<a
1598
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1599
><code class="literal">TRUE</code></a> on success
1600
1601
1602
</td>
1603
</tr>
1604
</tbody>
1605
</table></div>
1606
</div>
1607
<hr>
1608
<div class="refsect2" lang="en">
1609
<a name="id3082798"></a><h3>
1610
<a name="lu-group-setpass"></a>lu_group_setpass ()</h3>
1611
<a class="indexterm" name="id3082811"></a><pre class="programlisting"><a
579
1612
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
580
1613
>gboolean</a> lu_group_setpass (lu_context_t *context,
581
1614
struct lu_ent *ent,
583
1616
<a
584
1617
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
585
1618
>gboolean</a> crypted,
586
lu_error_t **error);</pre><p>
1619
lu_error_t **error);</pre>
1620
<p>
587
1621
Changes a group password.
588
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a contect
589
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the group, on success updated with current
1622
</p>
1623
<div class="variablelist"><table border="0">
1624
<col align="left" valign="top">
1625
<tbody>
1626
<tr>
1627
<td>
1628
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1629
<td>a contect
1630
</td>
1631
</tr>
1632
<tr>
1633
<td>
1634
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1635
<td>an entity describing the group, on success updated with current
590
1636
information and LU_SHADOWLASTCHANGE
591
</td></tr><tr><td><span class="term"><em class="parameter"><code>newpass</code></em>�:</span></td><td>new password
592
</td></tr><tr><td><span class="term"><em class="parameter"><code>crypted</code></em>�:</span></td><td>non-zero if <em class="parameter"><code>newpass</code></em> is already encrypted
593
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with an <span class="type">lu_error</span> if an error occurs
594
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
595
596
597
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2736162"></a><h3><a name="lu-group-removepass"></a>lu_group_removepass ()</h3><a class="indexterm" name="id2736173"></a><pre class="programlisting"><a
1637
</td>
1638
</tr>
1639
<tr>
1640
<td>
1641
<span class="term"><em class="parameter"><code>newpass</code></em> :</span></td>
1642
<td>new password
1643
</td>
1644
</tr>
1645
<tr>
1646
<td>
1647
<span class="term"><em class="parameter"><code>crypted</code></em> :</span></td>
1648
<td>non-zero if <em class="parameter"><code>newpass</code></em> is already encrypted
1649
</td>
1650
</tr>
1651
<tr>
1652
<td>
1653
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1654
<td>filled with an <span class="type">lu_error</span> if an error occurs
1655
</td>
1656
</tr>
1657
<tr>
1658
<td>
1659
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1660
<td>
1661
<a
1662
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1663
><code class="literal">TRUE</code></a> on success
1664
1665
1666
</td>
1667
</tr>
1668
</tbody>
1669
</table></div>
1670
</div>
1671
<hr>
1672
<div class="refsect2" lang="en">
1673
<a name="id3082979"></a><h3>
1674
<a name="lu-group-removepass"></a>lu_group_removepass ()</h3>
1675
<a class="indexterm" name="id3082993"></a><pre class="programlisting"><a
598
1676
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
599
1677
>gboolean</a> lu_group_removepass (lu_context_t *context,
600
1678
struct lu_ent *ent,
601
lu_error_t **error);</pre><p>
1679
lu_error_t **error);</pre>
1680
<p>
602
1681
Changes a group password to an empty string.
603
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
604
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the group, on success udpated with current
1682
</p>
1683
<div class="variablelist"><table border="0">
1684
<col align="left" valign="top">
1685
<tbody>
1686
<tr>
1687
<td>
1688
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1689
<td>a context
1690
</td>
1691
</tr>
1692
<tr>
1693
<td>
1694
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1695
<td>an entity describing the group, on success udpated with current
605
1696
information and LU_SHADOWLASTCHANGE
606
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with in <span class="type">lu_error</span> if an error occurs
607
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
608
609
610
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2736288"></a><h3><a name="lu-group-lock"></a>lu_group_lock ()</h3><a class="indexterm" name="id2736298"></a><pre class="programlisting"><a
1697
</td>
1698
</tr>
1699
<tr>
1700
<td>
1701
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1702
<td>filled with in <span class="type">lu_error</span> if an error occurs
1703
</td>
1704
</tr>
1705
<tr>
1706
<td>
1707
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1708
<td>
1709
<a
1710
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1711
><code class="literal">TRUE</code></a> on success
1712
1713
1714
</td>
1715
</tr>
1716
</tbody>
1717
</table></div>
1718
</div>
1719
<hr>
1720
<div class="refsect2" lang="en">
1721
<a name="id3083112"></a><h3>
1722
<a name="lu-group-lock"></a>lu_group_lock ()</h3>
1723
<a class="indexterm" name="id3083125"></a><pre class="programlisting"><a
611
1724
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
612
1725
>gboolean</a> lu_group_lock (lu_context_t *context,
613
1726
struct lu_ent *ent,
614
lu_error_t **error);</pre><p>
1727
lu_error_t **error);</pre>
1728
<p>
615
1729
Locks a group account
616
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
617
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the group, on success updated with current
1730
</p>
1731
<div class="variablelist"><table border="0">
1732
<col align="left" valign="top">
1733
<tbody>
1734
<tr>
1735
<td>
1736
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1737
<td>a context
1738
</td>
1739
</tr>
1740
<tr>
1741
<td>
1742
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1743
<td>an entity describing the group, on success updated with current
618
1744
information
619
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
620
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
621
622
623
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2736413"></a><h3><a name="lu-group-unlock"></a>lu_group_unlock ()</h3><a class="indexterm" name="id2736423"></a><pre class="programlisting"><a
1745
</td>
1746
</tr>
1747
<tr>
1748
<td>
1749
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1750
<td>filled with a <span class="type">lu_error</span> if an error occurs
1751
</td>
1752
</tr>
1753
<tr>
1754
<td>
1755
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1756
<td>
1757
<a
1758
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1759
><code class="literal">TRUE</code></a> on success
1760
1761
1762
</td>
1763
</tr>
1764
</tbody>
1765
</table></div>
1766
</div>
1767
<hr>
1768
<div class="refsect2" lang="en">
1769
<a name="id3083244"></a><h3>
1770
<a name="lu-group-unlock"></a>lu_group_unlock ()</h3>
1771
<a class="indexterm" name="id3083256"></a><pre class="programlisting"><a
624
1772
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
625
1773
>gboolean</a> lu_group_unlock (lu_context_t *context,
626
1774
struct lu_ent *ent,
627
lu_error_t **error);</pre><p>
1775
lu_error_t **error);</pre>
1776
<p>
628
1777
Unlocks a group account.
629
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
630
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the group, on success updated with current
1778
</p>
1779
<div class="variablelist"><table border="0">
1780
<col align="left" valign="top">
1781
<tbody>
1782
<tr>
1783
<td>
1784
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1785
<td>a context
1786
</td>
1787
</tr>
1788
<tr>
1789
<td>
1790
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1791
<td>an entity describing the group, on success updated with current
631
1792
information
632
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
633
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
634
635
636
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2736538"></a><h3><a name="lu-group-unlock-nonempty"></a>lu_group_unlock_nonempty ()</h3><a class="indexterm" name="id2736548"></a><pre class="programlisting"><a
1793
</td>
1794
</tr>
1795
<tr>
1796
<td>
1797
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1798
<td>filled with a <span class="type">lu_error</span> if an error occurs
1799
</td>
1800
</tr>
1801
<tr>
1802
<td>
1803
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1804
<td>
1805
<a
1806
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1807
><code class="literal">TRUE</code></a> on success
1808
1809
1810
</td>
1811
</tr>
1812
</tbody>
1813
</table></div>
1814
</div>
1815
<hr>
1816
<div class="refsect2" lang="en">
1817
<a name="id3083375"></a><h3>
1818
<a name="lu-group-unlock-nonempty"></a>lu_group_unlock_nonempty ()</h3>
1819
<a class="indexterm" name="id3083388"></a><pre class="programlisting"><a
637
1820
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
638
1821
>gboolean</a> lu_group_unlock_nonempty (lu_context_t *context,
639
1822
struct lu_ent *ent,
640
lu_error_t **error);</pre><p>
1823
lu_error_t **error);</pre>
1824
<p>
641
1825
Unlocks a group account. If unlocking the account would result in an empty
642
1826
password field, it fails with <code class="literal">lu_error_unlock_empty</code>. Note that the
643
1827
password can still be empty.
644
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
645
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the group, on success updated with current
1828
</p>
1829
<div class="variablelist"><table border="0">
1830
<col align="left" valign="top">
1831
<tbody>
1832
<tr>
1833
<td>
1834
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1835
<td>a context
1836
</td>
1837
</tr>
1838
<tr>
1839
<td>
1840
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1841
<td>an entity describing the group, on success updated with current
646
1842
information
647
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
648
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> on success
649
650
651
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2736671"></a><h3><a name="lu-group-islocked"></a>lu_group_islocked ()</h3><a class="indexterm" name="id2736682"></a><pre class="programlisting"><a
1843
</td>
1844
</tr>
1845
<tr>
1846
<td>
1847
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1848
<td>filled with a <span class="type">lu_error</span> if an error occurs
1849
</td>
1850
</tr>
1851
<tr>
1852
<td>
1853
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1854
<td>
1855
<a
1856
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1857
><code class="literal">TRUE</code></a> on success
1858
1859
1860
</td>
1861
</tr>
1862
</tbody>
1863
</table></div>
1864
</div>
1865
<hr>
1866
<div class="refsect2" lang="en">
1867
<a name="id3083520"></a><h3>
1868
<a name="lu-group-islocked"></a>lu_group_islocked ()</h3>
1869
<a class="indexterm" name="id3083533"></a><pre class="programlisting"><a
652
1870
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
653
1871
>gboolean</a> lu_group_islocked (lu_context_t *context,
654
1872
struct lu_ent *ent,
655
lu_error_t **error);</pre><p>
1873
lu_error_t **error);</pre>
1874
<p>
656
1875
Checks if a group account is locked.
657
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
658
</td></tr><tr><td><span class="term"><em class="parameter"><code>ent</code></em>�:</span></td><td>an entity describing the group
659
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
660
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td><code class="literal">TRUE</code> if the account is locked in at least one module
661
662
663
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2736796"></a><h3><a name="lu-groups-enumerate"></a>lu_groups_enumerate ()</h3><a class="indexterm" name="id2736808"></a><pre class="programlisting"><a
1876
</p>
1877
<div class="variablelist"><table border="0">
1878
<col align="left" valign="top">
1879
<tbody>
1880
<tr>
1881
<td>
1882
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1883
<td>a context
1884
</td>
1885
</tr>
1886
<tr>
1887
<td>
1888
<span class="term"><em class="parameter"><code>ent</code></em> :</span></td>
1889
<td>an entity describing the group
1890
</td>
1891
</tr>
1892
<tr>
1893
<td>
1894
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1895
<td>filled with a <span class="type">lu_error</span> if an error occurs
1896
</td>
1897
</tr>
1898
<tr>
1899
<td>
1900
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1901
<td>
1902
<a
1903
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1904
><code class="literal">TRUE</code></a> if the account is locked in at least one module
1905
1906
1907
</td>
1908
</tr>
1909
</tbody>
1910
</table></div>
1911
</div>
1912
<hr>
1913
<div class="refsect2" lang="en">
1914
<a name="id3083651"></a><h3>
1915
<a name="lu-groups-enumerate"></a>lu_groups_enumerate ()</h3>
1916
<a class="indexterm" name="id3083665"></a><pre class="programlisting"><a
664
1917
href="/usr/share/gtk-doc/html/gobject/gobject-Value-arrays.html#GValueArray"
665
1918
>GValueArray</a>* lu_groups_enumerate (lu_context_t *context,
666
1919
const char *pattern,
667
lu_error_t **error);</pre><p>
1920
lu_error_t **error);</pre>
1921
<p>
668
1922
Returns a list of all groups matching a pattern.
669
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
670
</td></tr><tr><td><span class="term"><em class="parameter"><code>pattern</code></em>�:</span></td><td>a glob-like pattern for group name
671
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
672
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td>an array of strings, each representing one group name. The array
1923
</p>
1924
<div class="variablelist"><table border="0">
1925
<col align="left" valign="top">
1926
<tbody>
1927
<tr>
1928
<td>
1929
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1930
<td>a context
1931
</td>
1932
</tr>
1933
<tr>
1934
<td>
1935
<span class="term"><em class="parameter"><code>pattern</code></em> :</span></td>
1936
<td>a glob-like pattern for group name
1937
</td>
1938
</tr>
1939
<tr>
1940
<td>
1941
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1942
<td>filled with a <span class="type">lu_error</span> if an error occurs
1943
</td>
1944
</tr>
1945
<tr>
1946
<td>
1947
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1948
<td>an array of strings, each representing one group name. The array
673
1949
should be freed by the caller.
674
1950
675
1951
676
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2736918"></a><h3><a name="lu-groups-enumerate-by-user"></a>lu_groups_enumerate_by_user ()</h3><a class="indexterm" name="id2736929"></a><pre class="programlisting"><a
1952
</td>
1953
</tr>
1954
</tbody>
1955
</table></div>
1956
</div>
1957
<hr>
1958
<div class="refsect2" lang="en">
1959
<a name="id3083775"></a><h3>
1960
<a name="lu-groups-enumerate-by-user"></a>lu_groups_enumerate_by_user ()</h3>
1961
<a class="indexterm" name="id3083789"></a><pre class="programlisting"><a
677
1962
href="/usr/share/gtk-doc/html/gobject/gobject-Value-arrays.html#GValueArray"
678
1963
>GValueArray</a>* lu_groups_enumerate_by_user (lu_context_t *context,
679
1964
const char *user,
680
lu_error_t **error);</pre><p>
1965
lu_error_t **error);</pre>
1966
<p>
681
1967
Returns a list of all groups containing an user <em class="parameter"><code>user</code></em>.
682
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
683
</td></tr><tr><td><span class="term"><em class="parameter"><code>user</code></em>�:</span></td><td>user name
684
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
685
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td>an array of strings, each representing one group name. The array
1968
</p>
1969
<div class="variablelist"><table border="0">
1970
<col align="left" valign="top">
1971
<tbody>
1972
<tr>
1973
<td>
1974
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
1975
<td>a context
1976
</td>
1977
</tr>
1978
<tr>
1979
<td>
1980
<span class="term"><em class="parameter"><code>user</code></em> :</span></td>
1981
<td>user name
1982
</td>
1983
</tr>
1984
<tr>
1985
<td>
1986
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
1987
<td>filled with a <span class="type">lu_error</span> if an error occurs
1988
</td>
1989
</tr>
1990
<tr>
1991
<td>
1992
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1993
<td>an array of strings, each representing one group name. The array
686
1994
should be freed by the caller.
687
1995
688
1996
689
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2737045"></a><h3><a name="lu-groups-enumerate-full"></a>lu_groups_enumerate_full ()</h3><a class="indexterm" name="id2737056"></a><pre class="programlisting"><a
1997
</td>
1998
</tr>
1999
</tbody>
2000
</table></div>
2001
</div>
2002
<hr>
2003
<div class="refsect2" lang="en">
2004
<a name="id3083905"></a><h3>
2005
<a name="lu-groups-enumerate-full"></a>lu_groups_enumerate_full ()</h3>
2006
<a class="indexterm" name="id3083918"></a><pre class="programlisting"><a
690
2007
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
691
2008
>GPtrArray</a>* lu_groups_enumerate_full (lu_context_t *context,
692
2009
const char *pattern,
693
lu_error_t **error);</pre><p>
2010
lu_error_t **error);</pre>
2011
<p>
694
2012
Returns a list of entities, one for each group matching a pattern.
695
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>context</code></em>�:</span></td><td>a context
696
</td></tr><tr><td><span class="term"><em class="parameter"><code>pattern</code></em>�:</span></td><td>a glob-like pattern for group name
697
</td></tr><tr><td><span class="term"><em class="parameter"><code>error</code></em>�:</span></td><td>filled with a <span class="type">lu_error</span> if an error occurs
698
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td>a list of pointers to group entities. The entities and the
2013
</p>
2014
<div class="variablelist"><table border="0">
2015
<col align="left" valign="top">
2016
<tbody>
2017
<tr>
2018
<td>
2019
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
2020
<td>a context
2021
</td>
2022
</tr>
2023
<tr>
2024
<td>
2025
<span class="term"><em class="parameter"><code>pattern</code></em> :</span></td>
2026
<td>a glob-like pattern for group name
2027
</td>
2028
</tr>
2029
<tr>
2030
<td>
2031
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
2032
<td>filled with a <span class="type">lu_error</span> if an error occurs
2033
</td>
2034
</tr>
2035
<tr>
2036
<td>
2037
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2038
<td>a list of pointers to group entities. The entities and the
699
2039
list should be freed by the caller.
700
2040
701
2041
702
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libuser-quota.html"><b><<�quota</b></a></td><td align="right"></td></tr></table></body></html>
2042
</td>
2043
</tr>
2044
</tbody>
2045
</table></div>
2046
</div>
2047
</div>
2048
</div>
2049
</body>
2050
</html>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1