File: ll2_remove_entry.3.adoc

package info (click to toggle)
util-linux 2.41.3-4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 93,048 kB
  • sloc: ansic: 179,151; sh: 22,703; yacc: 1,284; makefile: 527; xml: 422; python: 316; lex: 89; ruby: 75; csh: 37; exp: 19; sed: 16; perl: 15; sql: 9
file content (63 lines) | stat: -rw-r--r-- 1,429 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
//po4a: entry man manual
= ll2_remove_entry(3)
:doctype: manpage
:man manual: Programmer's Manual
:man source: util-linux {release-version}
:page-layout: base
:lib: liblastlog2
:firstversion: 2.40

== NAME

ll2_remove_entry - Removes all entries of a user.

== SYNOPSIS

*#include <lastlog2.h>*

*int ll2_remove_entry (struct ll2_context *__context__, const char *__user__,
		       char **__error__);*

== DESCRIPTION

Removes all database entries, defined in _context_, with the user name _user_.
If _context_ is NULL, the default database, defined in _LL2_DEFAULT_DATABASE_,
will be taken.

--------------------------------------
char    *error = NULL;
const   char *user = "root";

int ret = ll2_remove_entry (NULL, user, &error);
--------------------------------------

== RETURN VALUE

Returns 0 on success, -ENOMEM or -1 on other failure.
_error_ contains an error string if the return value is -1.
_error_ is not guaranteed to contain an error string, could also be NULL.
_error_ should be freed by the caller.

== AUTHORS

mailto:kukuk@suse.de[Thorsten Kukuk]

== SEE ALSO

*lastlog2*(3),
*ll2_new_context*(3),
*ll2_unref_context*(3),
*ll2_read_all*(3),
*ll2_write_entry*(3),
*ll2_read_entry*(3),
*ll2_update_login_time*(3),
*ll2_rename_user*(3),
*ll2_import_lastlog*(3)

include::man-common/bugreports.adoc[]

include::man-common/footer-lib.adoc[]

ifdef::translation[]
include::man-common/translation.adoc[]
endif::[]