liblastlog2/man/ll2_remove_entry.3.adoc

   1 //po4a: entry man manual
   2 = ll2_remove_entry(3)
   3 :doctype: manpage
   4 :man manual: Programmer's Manual
   5 :man source: util-linux {release-version}
   6 :page-layout: base
   7 :lib: liblastlog2
   8 :firstversion: 2.40
   9
  10 == NAME
  11
  12 ll2_remove_entry - Remove all entries of an user.
  13
  14 == SYNOPSIS
  15
  16 *#include <lastlog2.h>*
  17
  18 *int ll2_remove_entry (struct ll2_context *__context__, const char *__user__,
  19                        char **__error__);*
  20
  21 == DESCRIPTION
  22
  23 Removing all database entries, defined in _context_, with the user name _user_.
  24 If _context_ is NULL, the default database, defined in _LL2_DEFAULT_DATABASE_,
  25 will be taken.
  26
  27 --------------------------------------
  28 char    *error = NULL;
  29 const   char *user = "root";
  30
  31 int ret = ll2_remove_entry (NULL, user, &error);
  32 --------------------------------------
  33
  34 == RETURN VALUE
  35
  36 Returns 0 on success, -ENOMEM or -1 on other failure.
  37 _error_ contains an error string if the return value is -1.
  38 _error_ is not guaranteed to contain an error string, could also be NULL.
  39 _error_ should be freed by the caller.
  40
  41 == AUTHORS
  42
  43 Thorsten Kukuk (kukuk@suse.de)
  44
  45 == SEE ALSO
  46
  47 *lastlog2*(3),
  48 *ll2_new_context(3),
  49 *ll2_unref_context(3),
  50 *ll2_read_all*(3),
  51 *ll2_write_entry*(3),
  52 *ll2_read_entry*(3),
  53 *ll2_update_login_time*(3),
  54 *ll2_rename_user*(3),
  55 *ll2_import_lastlog*(3)
  56
  57 include::man-common/bugreports.adoc[]
  58
  59 include::man-common/footer-lib.adoc[]
  60
  61 ifdef::translation[]
  62 include::man-common/translation.adoc[]
  63 endif::[]